neuroagent 1.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NeuroAgent Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,273 @@
+# 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
+
+```bash
+npm install neuroagent
+```
+
+## Uso Rápido
+
+### JavaScript/TypeScript
+
+```javascript
+const { NeuroAgentClient, NeuroAgentWidget } = require('neuroagent');
+
+// Ou com ES modules
+import { NeuroAgentClient, NeuroAgentWidget } from 'neuroagent';
+```
+
+### Usando o Widget
+
+```javascript
+const widget = new NeuroAgentWidget({
+    apiUrl: 'http://localhost:8000',
+    agent: 'SupportAgent',
+    title: 'Assistente de IA',
+    position: 'bottom-right'
+});
+```
+
+### Usando o Cliente
+
+```javascript
+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:
+
+```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:
+
+```bash
+pip install -r requirements.txt
+```
+
+### Criando Agentes
+
+```python
+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
+
+```python
+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
+
+```python
+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:
+
+```python
+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
+
+```python
+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:
+
+```bash
+neuroagent start-server
+```
+
+Ou programaticamente:
+
+```python
+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
+
+```bash
+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:
+
+```html
+<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
+
+```bash
+# 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`:
+
+```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

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+export interface NeuroAgentConfig {
+    apiUrl?: string;
+    agent?: string;
+    apiKey?: string;
+    theme?: 'light' | 'dark';
+    position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+    title?: string;
+    welcomeMessage?: string;
+}
+
+export interface ChatResponse {
+    response: string;
+    agent: string;
+}
+
+export interface AgentList {
+    agents: string[];
+}
+
+export interface AgentRequest {
+    name: string;
+    goal: string;
+    model?: string;
+    apiKey?: string;
+    enablePlanning?: boolean;
+    tools?: string[];
+}
+
+export declare class NeuroAgentClient {
+    constructor(config: NeuroAgentConfig);
+    chat(message: string): Promise<ChatResponse>;
+    run(task: string): Promise<ChatResponse>;
+    createAgent(config: AgentRequest): Promise<any>;
+    listAgents(): Promise<AgentList>;
+    onWebSocket(event: 'open' | 'message' | 'error' | 'close', callback: (data?: any) => void): WebSocket;
+}
+
+export declare class NeuroAgentWidget {
+    constructor(config: NeuroAgentConfig);
+    open(): void;
+    close(): void;
+    toggle(): void;
+}
+
+export interface NeuroAgentInit {
+    init(config: NeuroAgentConfig): NeuroAgentWidget;
+}
+
+declare const NeuroAgent: {
+    init(config: NeuroAgentConfig): NeuroAgentWidget;
+    Client: typeof NeuroAgentClient;
+    Widget: typeof NeuroAgentWidget;
+};
+
+export default NeuroAgent;

package/dist/index.js

@@ -0,0 +1,215 @@
+/**
+ * NeuroAgent - Modern AI Agent Framework
+ * JavaScript/TypeScript Client
+ */
+
+const API_URL = 'http://localhost:8000';
+
+class NeuroAgentClient {
+    constructor(config = {}) {
+        this.apiUrl = config.apiUrl || API_URL;
+        this.agent = config.agent || 'default';
+        this.apiKey = config.apiKey || null;
+    }
+
+    async request(endpoint, data) {
+        const headers = {
+            'Content-Type': 'application/json'
+        };
+        
+        if (this.apiKey) {
+            headers['Authorization'] = `Bearer ${this.apiKey}`;
+        }
+
+        const response = await fetch(`${this.apiUrl}${endpoint}`, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({
+                agent: this.agent,
+                ...data
+            })
+        });
+
+        return response.json();
+    }
+
+    async chat(message) {
+        return this.request('/agent/chat', { message });
+    }
+
+    async run(task) {
+        return this.request('/agent/run', { message: task });
+    }
+
+    async createAgent(config) {
+        const response = await fetch(`${this.apiUrl}/agents`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(config)
+        });
+        return response.json();
+    }
+
+    async listAgents() {
+        const response = await fetch(`${this.apiUrl}/agents`);
+        return response.json();
+    }
+
+    onWebSocket(event, callback) {
+        const ws = new WebSocket(`${this.apiUrl.replace('http', 'ws')}/ws/${this.agent}`);
+        
+        ws.onopen = () => {
+            if (event === 'open') callback();
+        };
+        
+        ws.onmessage = (e) => {
+            const data = JSON.parse(e.data);
+            if (event === 'message') callback(data);
+        };
+        
+        ws.onerror = (error) => {
+            if (event === 'error') callback(error);
+        };
+        
+        ws.onclose = () => {
+            if (event === 'close') callback();
+        };
+
+        return ws;
+    }
+}
+
+class NeuroAgentWidget {
+    constructor(config) {
+        this.client = new NeuroAgentClient(config);
+        this.config = {
+            theme: config.theme || 'dark',
+            position: config.position || 'bottom-right',
+            title: config.title || 'AI Assistant',
+            welcomeMessage: config.welcomeMessage || 'Hello! How can I help you?',
+            ...config
+        };
+        
+        this.isOpen = false;
+        this.init();
+    }
+
+    init() {
+        this.createStyles();
+        this.createWidget();
+        this.createChat();
+        this.bindEvents();
+    }
+
+    createStyles() {
+        if (document.getElementById('neuroagent-styles')) return;
+        
+        const styles = document.createElement('style');
+        styles.id = 'neuroagent-styles';
+        styles.textContent = `
+            .na-widget { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; position: fixed; z-index: 999999; }
+            .na-widget-btn { width: 60px; height: 60px; border-radius: 50%; background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); border: none; cursor: pointer; box-shadow: 0 4px 15px rgba(102,126,234,0.4); display: flex; align-items: center; justify-content: center; transition: transform 0.3s; }
+            .na-widget-btn:hover { transform: scale(1.1); }
+            .na-widget-btn svg { width: 30px; height: 30px; fill: white; }
+            .na-chat { position: fixed; width: 380px; height: 500px; background: white; border-radius: 16px; box-shadow: 0 10px 40px rgba(0,0,0,0.2); display: none; flex-direction: column; overflow: hidden; }
+            .na-chat.open { display: flex; }
+            .na-chat-header { background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); color: white; padding: 16px; display: flex; align-items: center; justify-content: space-between; }
+            .na-chat-title { font-weight: 600; font-size: 16px; }
+            .na-chat-close { background: none; border: none; color: white; cursor: pointer; font-size: 20px; }
+            .na-messages { flex: 1; padding: 16px; overflow-y: auto; display: flex; flex-direction: column; gap: 12px; }
+            .na-msg { max-width: 80%; padding: 12px 16px; border-radius: 16px; font-size: 14px; line-height: 1.5; }
+            .na-msg.user { align-self: flex-end; background: #667eea; color: white; border-bottom-right-radius: 4px; }
+            .na-msg.assistant { align-self: flex-start; background: #f0f0f0; color: #333; border-bottom-left-radius: 4px; }
+            .na-msg.thinking { align-self: flex-start; background: #f0f0f0; color: #666; font-style: italic; }
+            .na-input-area { padding: 16px; border-top: 1px solid #eee; display: flex; gap: 8px; }
+            .na-input-area input { flex: 1; padding: 12px 16px; border: 1px solid #ddd; border-radius: 24px; outline: none; font-size: 14px; }
+            .na-input-area input:focus { border-color: #667eea; }
+            .na-input-area button { background: #667eea; color: white; border: none; padding: 12px 20px; border-radius: 24px; cursor: pointer; font-size: 14px; font-weight: 500; }
+            .na-input-area button:disabled { background: #ccc; cursor: not-allowed; }
+            .na-pos-bottom-right { bottom: 20px; right: 20px; }
+            .na-pos-bottom-left { bottom: 20px; left: 20px; }
+            .na-pos-top-right { top: 20px; right: 20px; }
+            .na-pos-top-left { top: 20px; left: 20px; }
+            .na-chat.na-pos-bottom-right, .na-chat.na-pos-bottom-left { bottom: 90px; }
+            .na-chat.na-pos-top-right, .na-chat.na-pos-top-left { top: 90px; }
+            .na-chat.na-pos-bottom-right, .na-chat.na-pos-top-right { right: 20px; }
+            .na-chat.na-pos-bottom-left, .na-chat.na-pos-top-left { left: 20px; }
+        `;
+        document.head.appendChild(styles);
+    }
+
+    createWidget() {
+        this.widget = document.createElement('div');
+        this.widget.className = `na-widget na-pos-${this.config.position}`;
+        this.widget.innerHTML = `
+            <button class="na-widget-btn" title="${this.config.title}">
+                <svg viewBox="0 0 24 24"><path d="M20 2H4c-1.1 0-2 .9-2 2v18l4-4h14c1.1 0 2-.9 2-2V4c0-1.1-.9-2-2-2zm0 14H6l-2 2V4h16v12z"/></svg>
+            </button>
+        `;
+        document.body.appendChild(this.widget);
+    }
+
+    createChat() {
+        this.chat = document.createElement('div');
+        this.chat.className = `na-chat na-pos-${this.config.position}`;
+        this.chat.innerHTML = `
+            <div class="na-chat-header">
+                <span class="na-chat-title">${this.config.title}</span>
+                <button class="na-chat-close">&times;</button>
+            </div>
+            <div class="na-messages"></div>
+            <div class="na-input-area">
+                <input type="text" placeholder="Type a message..." />
+                <button>Send</button>
+            </div>
+        `;
+        document.body.appendChild(this.chat);
+        this.messagesEl = this.chat.querySelector('.na-messages');
+        this.inputEl = this.chat.querySelector('input');
+        this.sendBtn = this.chat.querySelector('button');
+        this.addMessage(this.config.welcomeMessage, 'assistant');
+    }
+
+    bindEvents() {
+        this.widget.querySelector('.na-widget-btn').addEventListener('click', () => this.toggle());
+        this.chat.querySelector('.na-chat-close').addEventListener('click', () => this.close());
+        this.sendBtn.addEventListener('click', () => this.send());
+        this.inputEl.addEventListener('keypress', (e) => { if (e.key === 'Enter') this.send(); });
+    }
+
+    toggle() { this.isOpen ? this.close() : this.open(); }
+    open() { this.isOpen = true; this.chat.classList.add('open'); this.inputEl.focus(); }
+    close() { this.isOpen = false; this.chat.classList.remove('open'); }
+
+    addMessage(content, type = 'assistant') {
+        const msg = document.createElement('div');
+        msg.className = `na-msg ${type}`;
+        msg.textContent = content;
+        this.messagesEl.appendChild(msg);
+        this.messagesEl.scrollTop = this.messagesEl.scrollHeight;
+    }
+
+    async send() {
+        const msg = this.inputEl.value.trim();
+        if (!msg) return;
+        
+        this.inputEl.value = '';
+        this.addMessage(msg, 'user');
+        this.sendBtn.disabled = true;
+        this.addMessage('Thinking...', 'thinking');
+        
+        try {
+            const response = await this.client.chat(msg);
+            this.messagesEl.lastElementChild?.remove();
+            this.addMessage(response.response || 'No response', 'assistant');
+        } catch (error) {
+            this.messagesEl.lastElementChild?.remove();
+            this.addMessage('Error connecting to server', 'assistant');
+        }
+        
+        this.sendBtn.disabled = false;
+    }
+}
+
+module.exports = { NeuroAgentClient, NeuroAgentWidget };
+module.exports.default = { NeuroAgentClient, NeuroAgentWidget };

package/neuroagent/__init__.py

@@ -0,0 +1,29 @@
+"""
+NeuroAgent - Modern AI Agent Framework
+"""
+
+__version__ = "0.2.0"
+__author__ = "NeuroAgent Team"
+
+from neuroagent.agents.agent import Agent
+from neuroagent.team.team import Team
+from neuroagent.llm.base import LLMProvider
+from neuroagent.llm.openai_provider import OpenAIProvider
+from neuroagent.llm.local_model_provider import LocalModelProvider
+from neuroagent.tools.base import tool, Tool
+from neuroagent.memory.short_memory import ShortMemory
+from neuroagent.memory.long_memory import LongMemory
+from neuroagent.memory.vector_memory import VectorMemory
+
+__all__ = [
+    "Agent",
+    "Team",
+    "LLMProvider",
+    "OpenAIProvider",
+    "LocalModelProvider",
+    "tool",
+    "Tool",
+    "ShortMemory",
+    "LongMemory",
+    "VectorMemory",
+]

package/neuroagent/agents/__init__.py

@@ -0,0 +1,3 @@
+from neuroagent.agents.agent import Agent
+
+__all__ = ["Agent"]