CraftBot

Cos'è CraftBot?

CraftBot è un assistente AI personale che gira sul tuo PC ed è progettato per interpretare task, pianificare azioni ed eseguirle per aiutarti a raggiungere gli obiettivi. È pensato per funzionare in modo continuo così da poterti aiutare proattivamente a pianificare e avviare task in base alle tue preferenze e obiettivi.

Il progetto supporta più provider di modelli linguistici e include integrazioni, un sistema di memoria e un framework estensibile per ampliare le capacità dell'agente tramite MCP (Model Context Protocol) e skill personalizzate.

Caratteristiche Principali

• Bring Your Own Key (BYOK) LLM provider system: Seleziona e passa tra i provider LLM supportati inclusi OpenAI, Google Gemini, Anthropic Claude, BytePlus e locale Ollama.
• Sistema di memoria con consolidamento giornaliero: Distilla e consolida gli eventi della giornata a mezzanotte per supportare la personalizzazione continua.
• Comportamento proattivo dell'agente (con approvazione): Impara preferenze, abitudini e obiettivi di vita; può pianificare e avviare task, con approvazione inclusa nel workflow.
• Integrazione con tool esterni con supporto OAuth: Connettiti a servizi inclusi Google Workspace, Slack, Notion, Zoom, LinkedIn, Discord e Telegram (con altri in arrivo).
• Integrazione MCP per capacità estese: Usa Model Context Protocol per estendere le capacità dell'agente con tool e servizi esterni.
• Framework delle skill: Framework estensibile delle skill con skill integrate per pianificazione task, ricerca, code review e operazioni git.

Come Usare CraftBot

1. Installa i prerequisiti: Usa Python 3.10+ e clona il repository. Avrai anche bisogno di una API key per il tuo provider LLM scelto (OpenAI, Gemini o Anthropic sono menzionati).
2. Installa le dipendenze: Esegui python install.py dalla directory clonata CraftBot.
3. Avvia l'agente: Esegui python run.py. Al primo avvio ti guida nella configurazione delle API key.
4. Scegli una modalità interfaccia:
   • Browser (predefinita): python run.py (raccomandata; richiede Node.js 18+).
   • TUI: python run.py --tui (nessuna dipendenza Node.js menzionata).
   • CLI: python run.py --cli.
   • GUI (sperimentale): python run.py --gui install.py --gui (la modalità GUI è descritta esplicitamente come sperimentale; potrebbero verificarsi problemi durante il passaggio).
5. Inizia a interagire: Usa linguaggio naturale per parlare con l'agente e visualizza i comandi disponibili con /help. Puoi anche connettere integrazioni come Google, Slack e Notion dopo la configurazione.

Casi d'Uso

• Pianificazione e avvio task personali: Chiedi all'agente di pianificare task multi-step e avviare il lavoro allineato alle tue preferenze e obiettivi di vita, con workflow che include approvazione.
• Assistenza cross-tool tra app di lavoro: Usa le connessioni integrate (es. Google Workspace, Slack, Notion, Zoom, LinkedIn, Discord, Telegram) per task che spaziano su più servizi.
• Estensione capacità via MCP: Aggiungi o connetti tool e servizi esterni tramite MCP così l'agente può interagire con capacità aggiuntive oltre quelle integrate.
• Aiuto workflow per sviluppatori: Usa skill integrate come ricerca, code review e operazioni git per supportare il lavoro software direttamente dall'assistente.
• Scelta interfaccia adatta al tuo ambiente: Esegui in modalità browser per un'interfaccia web, usa TUI/CLI per workflow terminal leggeri, o prova la modalità GUI sperimentale se vuoi feedback visivo.

FAQ

• Quali modelli può usare CraftBot? CraftBot supporta un sistema BYOK LLM con più provider, inclusi OpenAI, Google Gemini, Anthropic Claude, BytePlus e locale Ollama.

• Ho bisogno di Node.js? Node.js 18+ è opzionale e richiesto solo per l'interfaccia browser; se non installato, l'installer fornisce istruzioni o puoi usare la modalità TUI.

• La modalità GUI è stabile? No—la modalità GUI è descritta come sperimentale e potresti incontrare problemi quando l'agente passa a GUI. Il progetto nota miglioramenti attivi.

• Posso estendere ciò che CraftBot può fare? Sì. Il repository elenca supporto per integrazioni MCP e un framework skills, entrambi pensati per estendere le capacità dell'agente.

• Quali integrazioni sono supportate out of the box? La pagina elenca integrazioni per Google Workspace, Slack, Notion, Zoom, LinkedIn, Discord e Telegram, con credenziali incorporate e supporto OAuth.

Alternative

• Agenti AI locali con uso di tool costruiti con framework: Se desideri una configurazione simile “agente gira sul tuo PC” ma con un ecosistema diverso, cerca framework che supportino tool calling, memoria e cambio di provider.
• Assistenti basati su chat con connessioni a tool esterni: Se il tuo obiettivo è una chat più semplice con integrazioni (piuttosto che pianificazione/esecuzione autonoma), considera assistenti focalizzati su flussi conversazionali con app collegate.
• Automazione della produttività da command-line: Per utenti che preferiscono automazione senza loop di pianificazione AI, alternative includono task runner e tool di automazione che orchestrano azioni basate su workflow predefiniti.
• Setup di agenti compatibili con MCP: Se il tuo bisogno principale è estendere le capacità via MCP, confronta altre architetture o implementazioni di agenti abilitate per MCP per adattarsi al tuo UI e set di tool preferiti.