Metadata-Version: 2.4
Name: smartagent-sf
Version: 0.1.3
Summary: Biblioteca Python para criar agentes de IA com execução determinística
Home-page: https://github.com/lhabacuc/smartagent
Author: Liedson Habacuc
Author-email: lisvaldosf@gmail.com
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENCE
Requires-Dist: requests>=2.25.0
Provides-Extra: dev
Requires-Dist: groq; extra == "dev"
Requires-Dist: openai; extra == "dev"
Requires-Dist: google-generativeai; extra == "dev"
Requires-Dist: ollama; extra == "dev"
Requires-Dist: llama-cpp-python; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-mock; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Requires-Dist: mypy; extra == "dev"
Requires-Dist: isort; extra == "dev"
Requires-Dist: requests; extra == "dev"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary


# SmartAgent 🤖

Biblioteca Python leve para criar agentes de IA com execução determinística em 3 fases.

## Características ✨

- **Multi-Provider**: Suporta Groq, OpenAI, Gemini, Grok, Ollama e Llama
- **Sem Schemas**: Não precisa de Pydantic ou definições complexas
- **3 Fases**: Análise → Execução → Resposta
- **Econômico**: Minimiza uso de tokens
- **Simples**: Menos de 500 linhas de código

## Instalação

```bash
# Instalar dependências
pip install requests
```

## Uso Rápido

```python
from agent import Agent

# Criar agente
agent = Agent(model="groq")

# Registrar ferramentas
@agent.tool
def get_products(max_price=100):
    return [{"nome": "Mouse", "preço": 50}]

# Executar
response = agent.chat("Quais produtos baratos?")
print(response)
```

## Instruções Customizadas

Você pode adicionar instruções personalizadas ao agente:

```python
agent = Agent(
    model="groq",
    info="""
    Você é um assistente especializado em e-commerce.
    - Sempre sugira produtos relacionados
    - Use tom amigável e profissional
    - Destaque promoções quando disponíveis
    """
)
```

## Providers Suportados

- **Groq**: `Agent(model="groq", api_key="...")`
- **OpenAI**: `Agent(model="openai", api_key="...")`
- **Gemini**: `Agent(model="gemini", api_key="...")`
- **Grok**: `Agent(model="grok", api_key="...")`
- **Ollama**: `Agent(model="ollama")` (local)
- **Llama**: `Agent(model="llama", api_key="...")`

## Variáveis de Ambiente

```bash
export GROQ_API_KEY="your-key"
export OPENAI_API_KEY="your-key"
export GEMINI_API_KEY="your-key"
export XAI_API_KEY="your-key"
export LLAMA_API_KEY="your-key"

export LLM="modelo-ai"
```

## Arquitetura

1. **Analyzer**: Determina quais ferramentas executar
2. **Executor**: Executa ferramentas com parâmetros
3. **Responder**: Gera resposta humanizada

## Exemplo Completo

Veja `examples/minimal_agent.py`
