NeuroAgent

Framework moderno, modular e simples para criar agentes de IA inteligentes com poucas linhas de código.

Recursos

• Criação Fácil de Agentes: Crie agentes de IA com apenas algumas linhas de código
• Equipes Multi-Agentes: Múltiplos agentes podem trabalhar juntos em tarefas complexas
• Sistema de Ferramentas: Ferramentas integradas para busca na web, execução de código, gerenciamento de arquivos e requisições HTTP
• Sistema de Memória: Memória de curto prazo, longo prazo e vetorial para contexto
• Planejamento: Decomposição automática de tarefas e planejamento
• Múltiplos Provedores de LLM: Suporte para OpenAI, Anthropic e modelos locais
• Servidor FastAPI: API REST para gerenciamento de agentes
• Suporte WebSocket: Comunicação em tempo real
• Widget JavaScript: Integração fácil com sites

Instalação

npm install neuroagent

Uso Rápido

JavaScript/TypeScript

const { NeuroAgentClient, NeuroAgentWidget } = require('neuroagent');

// Ou com ES modules
import { NeuroAgentClient, NeuroAgentWidget } from 'neuroagent';

Usando o Widget

const widget = new NeuroAgentWidget({
    apiUrl: 'http://localhost:8000',
    agent: 'SupportAgent',
    title: 'Assistente de IA',
    position: 'bottom-right'
});

Usando o Cliente

const client = new NeuroAgentClient({
    apiUrl: 'http://localhost:8000',
    agent: 'MyAgent'
});

// Chat com agente
const response = await client.chat('Olá, como você está?');
console.log(response);

// Executar tarefa do agente
const result = await client.run('Criar um app todo');
console.log(result);

Usando o Widget (CDN)

Adicione isso ao seu HTML:

<script src="https://cdn.neuroagent.ai/neuroagent.min.js"></script>
<script>
  NeuroAgent.init({
    apiUrl: "http://localhost:8000",
    agent: "SupportAgent",
    title: "Assistente de IA"
  });
</script>

Python (Backend)

O pacote também inclui o framework Python completo:

pip install -r requirements.txt

Criando seu Primeiro Agente de IA

import asyncio
from neuroagent import Agent

async def main():
    # Criar o agente
    agent = Agent(
        name="MeuAgente",
        goal="Ajudar usuários com suas perguntas"
    )
    
    # Executar o agente
    result = await agent.run("O que é NeuroAgent?")
    print(result)

# Executar o código
asyncio.run(main())

Explicação do Código

1. import asyncio - Importa o módulo asyncio para funções assíncronas
2. from neuroagent import Agent - Importa a classe Agent do neuroagent
3. async def main() - Define uma função assíncrona
4. await agent.run() - Executa o agente de forma assíncrona
5. asyncio.run(main()) - Executa a função assíncrona

Criando Agentes

from neuroagent import Agent

agent = Agent(
    name="MeuAgente",
    goal="Ajudar usuários com suas perguntas"
)

result = await agent.run("O que é NeuroAgent?")
print(result)

Agente com Ferramentas

agent = Agent(
    name="DevAgent",
    goal="Criar aplicações e escrever código"
)

agent.add_tool("web_search")
agent.add_tool("code_executor")
agent.add_tool("file_manager")

result = await agent.run("Criar um app web Python")

Ferramentas Personalizadas

from neuroagent.tools import tool

@tool(name="my_tool", description="Descrição da minha ferramenta")
def minha_ferramenta(param: str):
    return f"Resultado: {param}"

agent.register_tool(minha_ferramenta)

Sistema de Memória

O NeuroAgent suporta três tipos de memória:

agent = Agent(
    name="MeuAgente",
    goal="Meu objetivo",
    enable_short_memory=True,   # Histórico da conversa
    enable_long_memory=True,    # Armazenamento persistente
    enable_vector_memory=True   # Busca semântica
)

agent.save_memory("Info importante", memory_type="short")
agent.save_memory("Preferência do usuário", memory_type="long")
agent.save_memory("Contexto", memory_type="vector")

Equipes Multi-Agentes

from neuroagent import Agent, Team

researcher = Agent(name="Researcher", goal="Pesquisar tópicos")
developer = Agent(name="Developer", goal="Escrever código")
deployer = Agent(name="Deployer", goal="Implantar aplicações")

team = Team(name="SaaSTeam", goal="Criar apps SaaS")
team.add_agent(researcher)
team.add_agent(developer)
team.add_agent(deployer)

result = await team.run("Criar um app de gerenciamento de tarefas")

Servidor API

Inicie o servidor API:

neuroagent start-server

Ou programaticamente:

import uvicorn
from neuroagent.server.api_server import app

uvicorn.run(app, host="0.0.0.0", port=8000)

Endpoints da API

• GET /agents - Listar todos os agentes
• POST /agents - Criar um agente
• POST /agent/run - Executar um agente com uma tarefa
• POST /agent/chat - Conversar com um agente
• GET /teams - Listar todas as equipes
• POST /teams - Criar uma equipe
• POST /team/run - Executar uma equipe

Exemplo de Uso da API

curl -X POST http://localhost:8000/agent/run \
  -H "Content-Type: application/json" \
  -d '{
    "agent": "MyAgent",
    "message": "Olá!"
  }'

Integração com Website

Adicione o widget ao seu site:

<script src="https://cdn.neuroagent.ai/neuroagent.min.js"></script>
<script>
  NeuroAgent.init({
    apiUrl: "http://localhost:8000",
    agent: "SupportAgent",
    title: "Assistente de IA",
    position: "bottom-right"
  });
</script>

Comandos da CLI

# Iniciar um novo projeto
neuroagent init meu-projeto

# Criar um agente
neuroagent create-agent MeuAgente --goal "Ajudar usuários"

# Iniciar o servidor
neuroagent start-server --port 8000

# Listar ferramentas disponíveis
neuroagent list-agents

Configuração

Crie um arquivo .env:

OPENAI_API_KEY=sua-api-key-aqui
ANTHROPIC_API_KEY=sua-anthropic-key

Exemplos

Veja o diretório examples/ para mais exemplos:

• website_agent.py - Exemplo de chatbot para site
• dev_agent.py - Exemplo de assistente para desenvolvedores
• multi_agent_team.py - Colaboração multi-agente

Arquitetura

neuroagent/
├── agents/         # Implementação do agente
├── memory/         # Sistemas de memória (short, long, vector)
├── tools/          # Ferramentas integradas
├── planner/       # Planejamento de tarefas
├── llm/           # Provedores de LLM
├── team/          # Equipes multi-agentes
├── server/        # Servidores API e WebSocket
├── cli/           # Interface de linha de comando
├── frontend/      # Widget JavaScript
└── utils/         # Utilitários

Opções de Posição do Widget

• bottom-right (padrão)
• bottom-left
• top-right
• top-left

Licença

MIT License