Filter
Exclude
Time range
-
Near
github.com/timowhite88/Farnsโ€ฆ ๐Ÿง  Farnsworth: Your Claude Companion AI Give Claude superpowers: persistent memory, model swarms, multimodal understanding, and self-evolution. ๐Ÿ“ท ๐Ÿ“ท ๐Ÿ“ท ๐Ÿ“ท ๐Ÿ“ท ๐Ÿ“ท Documentation โ€ข Roadmap โ€ข Contributing โ€ข Docker ๐ŸŽฏ What is Farnsworth? Farnsworth is a companion AI system that integrates with Claude Code to give Claude capabilities it doesn't have on its own: Without FarnsworthWith Farnsworth๐Ÿšซ Claude forgets everything between sessionsโœ… Claude remembers your preferences forever๐Ÿšซ Claude is a single modelโœ… Model Swarm: 12 models collaborate via PSO๐Ÿšซ Claude can't see images or hear audioโœ… Multimodal: vision (CLIP/BLIP) voice (Whisper)๐Ÿšซ Claude never learns from feedbackโœ… Claude evolves and adapts to you๐Ÿšซ Single user onlyโœ… Team collaboration with shared memory๐Ÿšซ High RAM/VRAM requirementsโœ… Runs on <2GB RAM with efficient models All processing happens locally on your machine. Your data never leaves your computer. โœจ What's New in v0.5.0 ๐Ÿ Model Swarm - PSO-based collaborative inference with multiple small models ๐Ÿ”ฎ Proactive Intelligence - Anticipatory suggestions based on context and habits ๐Ÿš€ 12 New Models - Phi-4-mini, SmolLM2, Qwen3-4B, TinyLlama, BitNet 2B โšก Ultra-Efficient - Run on <2GB RAM with TinyLlama, Qwen3-0.6B ๐ŸŽฏ Smart Routing - Mixture-of-Experts automatically picks best model per task ๐Ÿ”„ Speculative Decoding - 2.5x speedup with draft verify pairs ๐Ÿ“Š Hardware Profiles - Auto-configure based on your available resources Previously Added (v0.4.0) ๐Ÿ–ผ๏ธ Vision Module - CLIP/BLIP image understanding, VQA, OCR ๐ŸŽค Voice Module - Whisper transcription, speaker diarization, TTS ๐Ÿ“ฆ Docker Support - One-command deployment with GPU support ๐Ÿ‘ฅ Team Collaboration - Shared memory pools, multi-user sessions ๐Ÿ Model Swarm: Collaborative Multi-Model Inference The Model Swarm system enables multiple small models to work together, achieving better results than any single model: Swarm Strategies StrategyDescriptionBest ForPSO CollaborativeParticle Swarm Optimization guides model selectionComplex tasksParallel VoteRun 3 models, vote on best responseQuality-criticalMixture of ExpertsRoute to specialist per task typeGeneral useSpeculative EnsembleFast model drafts, strong model verifiesSpeed qualityFastest FirstStart fast, escalate if confidence lowLow latencyConfidence FusionWeighted combination of outputsHigh reliability Supported Models (Jan 2025) ModelParamsRAMStrengthsPhi-4-mini-reasoning3.8B6GBRivals o1-mini in math/reasoningPhi-4-mini3.8B6GBGPT-3.5 class, 128K contextDeepSeek-R1-1.5B1.5B4GBo1-style reasoning, MIT licenseQwen3-4B4B5GBMMLU-Pro 74%, multilingualSmolLM2-1.7B1.7B3GBBest quality at sizeQwen3-0.6B0.6B2GBUltra-light, 100 languagesTinyLlama-1.1B1.1B2GBFastest, edge devicesBitNet-2B2B1GBNative 1-bit, 5-7x CPU speedupGemma-3n-E2B2B eff4GBMultimodal (text/image/audio)Phi-4-multimodal5.6B8GBVision speech reasoning Hardware Profiles Farnsworth auto-configures based on your hardware: minimal: # <4GB RAM: TinyLlama, Qwen3-0.6B cpu_only: # 8GB RAM, no GPU: BitNet, SmolLM2 low_vram: # 2-4GB VRAM: DeepSeek-R1, Qwen3-0.6B medium_vram: # 4-8GB VRAM: Phi-4-mini, Qwen3-4B high_vram: # 8GB VRAM: Full swarm with verification โšก Quick Start Option 1: Docker (Recommended) git clone github.com/timowhite88/Farnsโ€ฆ cd Farnsworth docker-compose -f docker/docker-compose.yml up -d Option 2: Local Install git clone github.com/timowhite88/Farnsโ€ฆ cd Farnsworth pip install -r requirements.txt # Install Ollama from ollama.ai, then: ollama pull deepseek-r1:1.5b # Optional: Add more models for swarm ollama pull phi4:mini ollama pull qwen3:0.6b ollama pull tinyllama:1.1b Configure Claude Code Add to your Claude Code MCP settings: { "mcpServers": { "farnsworth": { "command": "python", "args": ["-m", "farnsworth.mcp_server"], "cwd": "/path/to/Farnsworth" } } } Start Using! You: "Remember that I prefer TypeScript over JavaScript" Claude: โœ“ I'll remember that preference. [Next week, new session] You: "What language should I use for this project?" Claude: "Based on your preference for TypeScript..." ๐Ÿ“– Full Installation Guide โ†’ ๐ŸŒŸ Key Features ๐Ÿง  Advanced Memory System Claude finally remembers! Multi-tier hierarchical memory: Memory TypeDescriptionWorking MemoryCurrent conversation contextEpisodic MemoryTimeline of interactions, "on this day" recallSemantic Layers5-level abstraction hierarchyKnowledge GraphEntities, relationships, temporal edgesArchival MemoryPermanent vector-indexed storageMemory DreamingBackground consolidation during idle time ๐Ÿค– Agent Swarm (11 Specialists) Claude can delegate tasks to AI agents: Core AgentsDescriptionCode AgentProgramming, debugging, code reviewReasoning AgentLogic, math, step-by-step analysisResearch AgentInformation gathering, summarizationCreative AgentWriting, brainstorming, ideationAdvanced Agents (v0.3 )DescriptionPlanner AgentTask decomposition, dependency trackingCritic AgentQuality scoring, iterative refinementWeb AgentIntelligent browsing, form fillingFileSystem AgentProject understanding, smart searchCollaboration (v0.3 )DescriptionAgent DebatesMulti-perspective synthesisSpecialization LearningSkill development, task routingHierarchical TeamsManager coordination, load balancing ๐Ÿ–ผ๏ธ Vision Understanding (v0.4 ) See and understand images: CLIP Integration - Zero-shot classification, image embeddings BLIP Integration - Captioning, visual question answering OCR - Extract text from images (EasyOCR) Scene Graphs - Extract objects and relationships Image Similarity - Compare and search images ๐ŸŽค Voice Interaction (v0.4 ) Hear and speak: Whisper Transcription - Real-time and batch processing Speaker Diarization - Identify different speakers Text-to-Speech - Multiple voice options Voice Commands - Natural language control Continuous Listening - Hands-free mode ๐Ÿ‘ฅ Team Collaboration (v0.4 ) Work together with shared AI: Shared Memory Pools - Team knowledge bases Multi-User Support - Individual profiles and preferences Permission System - Role-based access control Collaborative Sessions - Real-time multi-user interaction Audit Logging - Compliance-ready access trails ๐Ÿ“ˆ Self-Evolution Farnsworth learns from your feedback and improves automatically: Fitness Tracking - Monitors task success, efficiency, satisfaction Genetic Optimization - Evolves better configurations over time User Avatar - Builds a model of your preferences LoRA Evolution - Adapts model weights to your usage ๐Ÿ” Smart Retrieval (RAG 2.0) Self-refining retrieval that gets better at finding relevant information: Hybrid Search - Semantic BM25 keyword search Query Understanding - Intent classification, expansion Multi-hop Retrieval - Complex question answering Context Compression - Token-efficient memory injection Source Attribution - Confidence scoring ๐Ÿ› ๏ธ Architecture โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Claude Code โ”‚ โ”‚ (Your AI Programming Partner) โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ MCP Protocol โ–ผ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Farnsworth MCP Server โ”‚ โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ โ”‚ โ”‚ Memory โ”‚ โ”‚ Agent โ”‚ โ”‚Evolution โ”‚ โ”‚Multimodalโ”‚ โ”‚ โ”‚ โ”‚ Tools โ”‚ โ”‚ Tools โ”‚ โ”‚ Tools โ”‚ โ”‚ Tools โ”‚ โ”‚ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”‚ โ”‚ โ–ผ โ–ผ โ–ผ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Memory โ”‚ โ”‚ Agent โ”‚ โ”‚ Multimodal โ”‚ โ”‚ System โ”‚ โ”‚ Swarm โ”‚ โ”‚ Engine โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ€ข Episodic โ”‚ โ”‚ โ€ข Planner โ”‚ โ”‚ โ€ข Vision โ”‚ โ”‚ โ€ข Semantic โ”‚ โ”‚ โ€ข Critic โ”‚ โ”‚ (CLIP/BLIP)โ”‚ โ”‚ โ€ข Knowledge โ”‚ โ”‚ โ€ข Web โ”‚ โ”‚ โ€ข Voice โ”‚ โ”‚ Graph v2 โ”‚ โ”‚ โ€ข FileSystem โ”‚ โ”‚ (Whisper) โ”‚ โ”‚ โ€ข Archival โ”‚ โ”‚ โ€ข Debates โ”‚ โ”‚ โ€ข OCR โ”‚ โ”‚ โ€ข Sharing โ”‚ โ”‚ โ€ข Teams โ”‚ โ”‚ โ€ข TTS โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”‚ โ”‚ โ–ผ โ–ผ โ–ผ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Evolution โ”‚ โ”‚Collaboration โ”‚ โ”‚ Storage โ”‚ โ”‚ Engine โ”‚ โ”‚ System โ”‚ โ”‚ Backends โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ€ข Genetic โ”‚ โ”‚ โ€ข Multi-User โ”‚ โ”‚ โ€ข FAISS โ”‚ โ”‚ Optimizer โ”‚ โ”‚ โ€ข Shared โ”‚ โ”‚ โ€ข ChromaDB โ”‚ โ”‚ โ€ข Fitness โ”‚ โ”‚ Memory โ”‚ โ”‚ โ€ข Redis โ”‚ โ”‚ Tracker โ”‚ โ”‚ โ€ข Sessions โ”‚ โ”‚ โ€ข SQLite โ”‚ โ”‚ โ€ข LoRA โ”‚ โ”‚ โ€ข Permissionsโ”‚ โ”‚ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”‚ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ–ผ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Model Swarm (v0.5 ) โ”‚ โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ โ”‚ โ”‚ PSO Collaborative Engine โ”‚ โ”‚ โ”‚ โ”‚ โ€ข Particle positions = model configs โ”‚ โ”‚ โ”‚ โ”‚ โ€ข Velocity = adaptation direction โ”‚ โ”‚ โ”‚ โ”‚ โ€ข Global/personal best tracking โ”‚ โ”‚ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ โ”‚ โ”‚ Phi-4 โ”‚ โ”‚DeepSeek โ”‚ โ”‚ Qwen3 โ”‚ โ”‚ SmolLM2 โ”‚ โ”‚ โ”‚ โ”‚ mini โ”‚ โ”‚ R1-1.5B โ”‚ โ”‚ 0.6B/4B โ”‚ โ”‚ 1.7B โ”‚ โ”‚ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ โ”‚ โ”‚TinyLlama โ”‚ โ”‚ BitNet โ”‚ โ”‚ Gemma โ”‚ โ”‚ Cascade โ”‚ โ”‚ โ”‚ โ”‚ 1.1B โ”‚ โ”‚ 2B(1-bit)โ”‚ โ”‚ 3n-E2B โ”‚ โ”‚ (hybrid) โ”‚ โ”‚ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ ๐Ÿ”ง Tools Available to Claude Once connected, Claude has access to these tools: ToolDescriptionfarnsworth_remember(content, tags)Store information in long-term memoryfarnsworth_recall(query, limit)Search and retrieve relevant memoriesfarnsworth_delegate(task, agent_type)Delegate to specialist agentfarnsworth_evolve(feedback)Provide feedback for system improvementfarnsworth_status()Get system health and statisticsfarnsworth_vision(image, task)Analyze images (caption, VQA, OCR)farnsworth_voice(audio, task)Process audio (transcribe, diarize)farnsworth_collaborate(action, ...)Team collaboration operationsfarnsworth_swarm(prompt, strategy)NEW: Multi-model collaborative inference ๐Ÿ“ฆ Docker Deployment Multiple deployment profiles available: # Basic deployment docker-compose -f docker/docker-compose.yml up -d # With GPU support docker-compose -f docker/docker-compose.yml --profile gpu up -d # With Ollama ChromaDB docker-compose -f docker/docker-compose.yml --profile ollama --profile chromadb up -d # Development mode (hot reload debugger) docker-compose -f docker/docker-compose.yml --profile dev up -d See docker/docker-compose.yml for all options. ๐Ÿ“Š Dashboard Farnsworth includes a Streamlit dashboard for visualization: python main.py --ui # Or with Docker: docker-compose -f docker/docker-compose.yml --profile ui-only up -d ๐Ÿ“ธ Dashboard Features Memory Browser - Search and explore all stored memories Episodic Timeline - Visual history of interactions Knowledge Graph - 3D entity relationships Agent Monitor - Active agents and task history Evolution Dashboard - Fitness metrics and improvement trends Team Collaboration - Shared pools and active sessions Model Swarm Monitor - PSO state, model performance, strategy stats ๐Ÿš€ Roadmap See ROADMAP.md for detailed plans. Completed โœ… v0.1.0 - Core memory, agents, evolution v0.2.0 - Enhanced memory (episodic, semantic, sharing) v0.3.0 - Advanced agents (planner, critic, web, filesystem, debates, teams) v0.4.0 - Multimodal (vision, voice) collaboration Docker v0.5.0 - Model Swarm 12 new models hardware profiles Coming Next ๐ŸŽฌ Video understanding and summarization ๐Ÿ” Encryption at rest (AES-256) โ˜๏ธ Cloud deployment templates (AWS, Azure, GCP) ๐Ÿ“Š Performance optimization (<100ms recall) ๐Ÿ’ก Why "Farnsworth"? Named after Professor Hubert J. Farnsworth from Futurama - a brilliant inventor who created countless gadgets and whose catchphrase "Good news, everyone!" perfectly captures what we hope you'll feel when using this tool with Claude. ๐Ÿ“‹ Requirements MinimumRecommendedWith Full SwarmPython 3.10 Python 3.11 Python 3.11 4GB RAM8GB RAM16GB RAM2-core CPU4-core CPU8-core CPU5GB storage20GB storage50GB storage-4GB VRAM8GB VRAM Supported Platforms: Windows 10 , macOS 11 , Linux Optional Dependencies: ollama - Local LLM inference (recommended) llama-cpp-python - Direct GGUF inference torch - GPU acceleration transformers - Vision/Voice models playwright - Web browsing agent whisper - Voice transcription ๐Ÿ“„ License Farnsworth is dual-licensed: Use CaseLicensePersonal / Educational / Non-commercialFREECommercial (revenue > $1M or enterprise)Commercial License Required See LICENSE for details. For commercial licensing, contact via GitHub. ๐Ÿค Contributing We welcome contributions! See CONTRIBUTING.md for guidelines. Priority Areas: Video understanding module Cloud deployment templates Performance benchmarks Additional model integrations Documentation improvements ๐Ÿ“š Documentation ๐Ÿ“– User Guide - Complete usage documentation ๐Ÿ—บ๏ธ Roadmap - Future plans and features ๐Ÿค Contributing - How to contribute ๐Ÿ“œ License - License terms ๐Ÿณ Docker Guide - Container deployment ๐Ÿ Model Configs - Supported models and swarm configs ๐Ÿ”— Research References Model Swarm implementation inspired by: Model Swarms: Collaborative Search via Swarm Intelligence Harnessing Multiple LLMs: Survey on LLM Ensemble Small Language Models - MIT Tech Review โญ Star History If Farnsworth helps you, consider giving it a star! โญ
2
181
Major Update to Farnsworth Today v0.05.0 is now Live ๐Ÿง  Farnsworth: Your Claude Companion AI Give Claude superpowers: persistent memory, model swarms, multimodal understanding, and self-evolution. ๐Ÿ“ท ๐Ÿ“ท ๐Ÿ“ท ๐Ÿ“ท ๐Ÿ“ท ๐Ÿ“ท Documentation โ€ข Roadmap โ€ข Contributing โ€ข Docker ๐ŸŽฏ What is Farnsworth? Farnsworth is a companion AI system that integrates with Claude Code to give Claude capabilities it doesn't have on its own: Without FarnsworthWith Farnsworth๐Ÿšซ Claude forgets everything between sessionsโœ… Claude remembers your preferences forever๐Ÿšซ Claude is a single modelโœ… Model Swarm: 12 models collaborate via PSO๐Ÿšซ Claude can't see images or hear audioโœ… Multimodal: vision (CLIP/BLIP) voice (Whisper)๐Ÿšซ Claude never learns from feedbackโœ… Claude evolves and adapts to you๐Ÿšซ Single user onlyโœ… Team collaboration with shared memory๐Ÿšซ High RAM/VRAM requirementsโœ… Runs on <2GB RAM with efficient models All processing happens locally on your machine. Your data never leaves your computer. โœจ What's New in v0.5.0 ๐Ÿ Model Swarm - PSO-based collaborative inference with multiple small models ๐Ÿ”ฎ Proactive Intelligence - Anticipatory suggestions based on context and habits ๐Ÿš€ 12 New Models - Phi-4-mini, SmolLM2, Qwen3-4B, TinyLlama, BitNet 2B โšก Ultra-Efficient - Run on <2GB RAM with TinyLlama, Qwen3-0.6B ๐ŸŽฏ Smart Routing - Mixture-of-Experts automatically picks best model per task ๐Ÿ”„ Speculative Decoding - 2.5x speedup with draft verify pairs ๐Ÿ“Š Hardware Profiles - Auto-configure based on your available resources Previously Added (v0.4.0) ๐Ÿ–ผ๏ธ Vision Module - CLIP/BLIP image understanding, VQA, OCR ๐ŸŽค Voice Module - Whisper transcription, speaker diarization, TTS ๐Ÿ“ฆ Docker Support - One-command deployment with GPU support ๐Ÿ‘ฅ Team Collaboration - Shared memory pools, multi-user sessions ๐Ÿ Model Swarm: Collaborative Multi-Model Inference The Model Swarm system enables multiple small models to work together, achieving better results than any single model: Swarm Strategies StrategyDescriptionBest ForPSO CollaborativeParticle Swarm Optimization guides model selectionComplex tasksParallel VoteRun 3 models, vote on best responseQuality-criticalMixture of ExpertsRoute to specialist per task typeGeneral useSpeculative EnsembleFast model drafts, strong model verifiesSpeed qualityFastest FirstStart fast, escalate if confidence lowLow latencyConfidence FusionWeighted combination of outputsHigh reliability Supported Models (Jan 2025) ModelParamsRAMStrengthsPhi-4-mini-reasoning3.8B6GBRivals o1-mini in math/reasoningPhi-4-mini3.8B6GBGPT-3.5 class, 128K contextDeepSeek-R1-1.5B1.5B4GBo1-style reasoning, MIT licenseQwen3-4B4B5GBMMLU-Pro 74%, multilingualSmolLM2-1.7B1.7B3GBBest quality at sizeQwen3-0.6B0.6B2GBUltra-light, 100 languagesTinyLlama-1.1B1.1B2GBFastest, edge devicesBitNet-2B2B1GBNative 1-bit, 5-7x CPU speedupGemma-3n-E2B2B eff4GBMultimodal (text/image/audio)Phi-4-multimodal5.6B8GBVision speech reasoning Hardware Profiles Farnsworth auto-configures based on your hardware: minimal: # <4GB RAM: TinyLlama, Qwen3-0.6B cpu_only: # 8GB RAM, no GPU: BitNet, SmolLM2 low_vram: # 2-4GB VRAM: DeepSeek-R1, Qwen3-0.6B medium_vram: # 4-8GB VRAM: Phi-4-mini, Qwen3-4B high_vram: # 8GB VRAM: Full swarm with verification โšก Quick Start Option 1: Docker (Recommended) git clone github.com/timowhite88/Farnsโ€ฆ cd Farnsworth docker-compose -f docker/docker-compose.yml up -d Option 2: Local Install git clone github.com/timowhite88/Farnsโ€ฆ cd Farnsworth pip install -r requirements.txt # Install Ollama from ollama.ai, then: ollama pull deepseek-r1:1.5b # Optional: Add more models for swarm ollama pull phi4:mini ollama pull qwen3:0.6b ollama pull tinyllama:1.1b Configure Claude Code Add to your Claude Code MCP settings: { "mcpServers": { "farnsworth": { "command": "python", "args": ["-m", "farnsworth.mcp_server"], "cwd": "/path/to/Farnsworth" } } } Start Using! You: "Remember that I prefer TypeScript over JavaScript" Claude: โœ“ I'll remember that preference. [Next week, new session] You: "What language should I use for this project?" Claude: "Based on your preference for TypeScript..." ๐Ÿ“– Full Installation Guide โ†’ ๐ŸŒŸ Key Features ๐Ÿง  Advanced Memory System Claude finally remembers! Multi-tier hierarchical memory: Memory TypeDescriptionWorking MemoryCurrent conversation contextEpisodic MemoryTimeline of interactions, "on this day" recallSemantic Layers5-level abstraction hierarchyKnowledge GraphEntities, relationships, temporal edgesArchival MemoryPermanent vector-indexed storageMemory DreamingBackground consolidation during idle time ๐Ÿค– Agent Swarm (11 Specialists) Claude can delegate tasks to AI agents: Core AgentsDescriptionCode AgentProgramming, debugging, code reviewReasoning AgentLogic, math, step-by-step analysisResearch AgentInformation gathering, summarizationCreative AgentWriting, brainstorming, ideationAdvanced Agents (v0.3 )DescriptionPlanner AgentTask decomposition, dependency trackingCritic AgentQuality scoring, iterative refinementWeb AgentIntelligent browsing, form fillingFileSystem AgentProject understanding, smart searchCollaboration (v0.3 )DescriptionAgent DebatesMulti-perspective synthesisSpecialization LearningSkill development, task routingHierarchical TeamsManager coordination, load balancing ๐Ÿ–ผ๏ธ Vision Understanding (v0.4 ) See and understand images: CLIP Integration - Zero-shot classification, image embeddings BLIP Integration - Captioning, visual question answering OCR - Extract text from images (EasyOCR) Scene Graphs - Extract objects and relationships Image Similarity - Compare and search images ๐ŸŽค Voice Interaction (v0.4 ) Hear and speak: Whisper Transcription - Real-time and batch processing Speaker Diarization - Identify different speakers Text-to-Speech - Multiple voice options Voice Commands - Natural language control Continuous Listening - Hands-free mode ๐Ÿ‘ฅ Team Collaboration (v0.4 ) Work together with shared AI: Shared Memory Pools - Team knowledge bases Multi-User Support - Individual profiles and preferences Permission System - Role-based access control Collaborative Sessions - Real-time multi-user interaction Audit Logging - Compliance-ready access trails ๐Ÿ“ˆ Self-Evolution Farnsworth learns from your feedback and improves automatically: Fitness Tracking - Monitors task success, efficiency, satisfaction Genetic Optimization - Evolves better configurations over time User Avatar - Builds a model of your preferences LoRA Evolution - Adapts model weights to your usage ๐Ÿ” Smart Retrieval (RAG 2.0) Self-refining retrieval that gets better at finding relevant information: Hybrid Search - Semantic BM25 keyword search Query Understanding - Intent classification, expansion Multi-hop Retrieval - Complex question answering Context Compression - Token-efficient memory injection Source Attribution - Confidence scoring ๐Ÿ› ๏ธ Architecture โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Claude Code โ”‚ โ”‚ (Your AI Programming Partner) โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ MCP Protocol โ–ผ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Farnsworth MCP Server โ”‚ โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ โ”‚ โ”‚ Memory โ”‚ โ”‚ Agent โ”‚ โ”‚Evolution โ”‚ โ”‚Multimodalโ”‚ โ”‚ โ”‚ โ”‚ Tools โ”‚ โ”‚ Tools โ”‚ โ”‚ Tools โ”‚ โ”‚ Tools โ”‚ โ”‚ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”‚ โ”‚ โ–ผ โ–ผ โ–ผ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Memory โ”‚ โ”‚ Agent โ”‚ โ”‚ Multimodal โ”‚ โ”‚ System โ”‚ โ”‚ Swarm โ”‚ โ”‚ Engine โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ€ข Episodic โ”‚ โ”‚ โ€ข Planner โ”‚ โ”‚ โ€ข Vision โ”‚ โ”‚ โ€ข Semantic โ”‚ โ”‚ โ€ข Critic โ”‚ โ”‚ (CLIP/BLIP)โ”‚ โ”‚ โ€ข Knowledge โ”‚ โ”‚ โ€ข Web โ”‚ โ”‚ โ€ข Voice โ”‚ โ”‚ Graph v2 โ”‚ โ”‚ โ€ข FileSystem โ”‚ โ”‚ (Whisper) โ”‚ โ”‚ โ€ข Archival โ”‚ โ”‚ โ€ข Debates โ”‚ โ”‚ โ€ข OCR โ”‚ โ”‚ โ€ข Sharing โ”‚ โ”‚ โ€ข Teams โ”‚ โ”‚ โ€ข TTS โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”‚ โ”‚ โ–ผ โ–ผ โ–ผ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Evolution โ”‚ โ”‚Collaboration โ”‚ โ”‚ Storage โ”‚ โ”‚ Engine โ”‚ โ”‚ System โ”‚ โ”‚ Backends โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ€ข Genetic โ”‚ โ”‚ โ€ข Multi-User โ”‚ โ”‚ โ€ข FAISS โ”‚ โ”‚ Optimizer โ”‚ โ”‚ โ€ข Shared โ”‚ โ”‚ โ€ข ChromaDB โ”‚ โ”‚ โ€ข Fitness โ”‚ โ”‚ Memory โ”‚ โ”‚ โ€ข Redis โ”‚ โ”‚ Tracker โ”‚ โ”‚ โ€ข Sessions โ”‚ โ”‚ โ€ข SQLite โ”‚ โ”‚ โ€ข LoRA โ”‚ โ”‚ โ€ข Permissionsโ”‚ โ”‚ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”‚ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ–ผ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Model Swarm (v0.5 ) โ”‚ โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ โ”‚ โ”‚ PSO Collaborative Engine โ”‚ โ”‚ โ”‚ โ”‚ โ€ข Particle positions = model configs โ”‚ โ”‚ โ”‚ โ”‚ โ€ข Velocity = adaptation direction โ”‚ โ”‚ โ”‚ โ”‚ โ€ข Global/personal best tracking โ”‚ โ”‚ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”‚ โ”‚ โ”‚ โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ โ”‚ โ”‚ Phi-4 โ”‚ โ”‚DeepSeek โ”‚ โ”‚ Qwen3 โ”‚ โ”‚ SmolLM2 โ”‚ โ”‚ โ”‚ โ”‚ mini โ”‚ โ”‚ R1-1.5B โ”‚ โ”‚ 0.6B/4B โ”‚ โ”‚ 1.7B โ”‚ โ”‚ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ โ”‚ โ”‚TinyLlama โ”‚ โ”‚ BitNet โ”‚ โ”‚ Gemma โ”‚ โ”‚ Cascade โ”‚ โ”‚ โ”‚ โ”‚ 1.1B โ”‚ โ”‚ 2B(1-bit)โ”‚ โ”‚ 3n-E2B โ”‚ โ”‚ (hybrid) โ”‚ โ”‚ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ ๐Ÿ”ง Tools Available to Claude Once connected, Claude has access to these tools: ToolDescriptionfarnsworth_remember(content, tags)Store information in long-term memoryfarnsworth_recall(query, limit)Search and retrieve relevant memoriesfarnsworth_delegate(task, agent_type)Delegate to specialist agentfarnsworth_evolve(feedback)Provide feedback for system improvementfarnsworth_status()Get system health and statisticsfarnsworth_vision(image, task)Analyze images (caption, VQA, OCR)farnsworth_voice(audio, task)Process audio (transcribe, diarize)farnsworth_collaborate(action, ...)Team collaboration operationsfarnsworth_swarm(prompt, strategy)NEW: Multi-model collaborative inference ๐Ÿ“ฆ Docker Deployment Multiple deployment profiles available: # Basic deployment docker-compose -f docker/docker-compose.yml up -d # With GPU support docker-compose -f docker/docker-compose.yml --profile gpu up -d # With Ollama ChromaDB docker-compose -f docker/docker-compose.yml --profile ollama --profile chromadb up -d # Development mode (hot reload debugger) docker-compose -f docker/docker-compose.yml --profile dev up -d See docker/docker-compose.yml for all options. ๐Ÿ“Š Dashboard Farnsworth includes a Streamlit dashboard for visualization: python main.py --ui # Or with Docker: docker-compose -f docker/docker-compose.yml --profile ui-only up -d ๐Ÿ“ธ Dashboard Features Memory Browser - Search and explore all stored memories Episodic Timeline - Visual history of interactions Knowledge Graph - 3D entity relationships Agent Monitor - Active agents and task history Evolution Dashboard - Fitness metrics and improvement trends Team Collaboration - Shared pools and active sessions Model Swarm Monitor - PSO state, model performance, strategy stats ๐Ÿš€ Roadmap See ROADMAP.md for detailed plans. Completed โœ… v0.1.0 - Core memory, agents, evolution v0.2.0 - Enhanced memory (episodic, semantic, sharing) v0.3.0 - Advanced agents (planner, critic, web, filesystem, debates, teams) v0.4.0 - Multimodal (vision, voice) collaboration Docker v0.5.0 - Model Swarm 12 new models hardware profiles Coming Next ๐ŸŽฌ Video understanding and summarization ๐Ÿ” Encryption at rest (AES-256) โ˜๏ธ Cloud deployment templates (AWS, Azure, GCP) ๐Ÿ“Š Performance optimization (<100ms recall) ๐Ÿ’ก Why "Farnsworth"? Named after Professor Hubert J. Farnsworth from Futurama - a brilliant inventor who created countless gadgets and whose catchphrase "Good news, everyone!" perfectly captures what we hope you'll feel when using this tool with Claude. ๐Ÿ“‹ Requirements MinimumRecommendedWith Full SwarmPython 3.10 Python 3.11 Python 3.11 4GB RAM8GB RAM16GB RAM2-core CPU4-core CPU8-core CPU5GB storage20GB storage50GB storage-4GB VRAM8GB VRAM Supported Platforms: Windows 10 , macOS 11 , Linux Optional Dependencies: ollama - Local LLM inference (recommended) llama-cpp-python - Direct GGUF inference torch - GPU acceleration transformers - Vision/Voice models playwright - Web browsing agent whisper - Voice transcription ๐Ÿ“„ License Farnsworth is dual-licensed: Use CaseLicensePersonal / Educational / Non-commercialFREECommercial (revenue > $1M or enterprise)Commercial License Required See LICENSE for details. For commercial licensing, contact via GitHub. ๐Ÿค Contributing We welcome contributions! See CONTRIBUTING.md for guidelines. Priority Areas: Video understanding module Cloud deployment templates Performance benchmarks Additional model integrations Documentation improvements ๐Ÿ“š Documentation ๐Ÿ“– User Guide - Complete usage documentation ๐Ÿ—บ๏ธ Roadmap - Future plans and features ๐Ÿค Contributing - How to contribute ๐Ÿ“œ License - License terms ๐Ÿณ Docker Guide - Container deployment ๐Ÿ Model Configs - Supported models and swarm configs ๐Ÿ”— Research References Model Swarm implementation inspired by: Model Swarms: Collaborative Search via Swarm Intelligence Harnessing Multiple LLMs: Survey on LLM Ensemble Small Language Models - MIT Tech Review โญ Star History If Farnsworth helps you, consider giving it a star! โญ
2
171
เฎ•เฎฑเฏเฎฑเฎฒเฏ เฎ…เฎŸเฏˆเฎตเฏ เฎคเฎฟเฎฑเฎฉเฏ เฎคเฏ‡เฎฐเฏเฎตเฏ เฎ•เฎฉเฏเฎฉเฎฟเฎฏเฎพเฎ•เฏเฎฎเฎฐเฎฟ 'เฎŸเฎพเฎชเฏ' #Kanyakumari | #coimbatore | #LearningDirectory | #Learningskill dinamalar.com
7
977
"knowledge is all about sharing. The much you will share it, the more you will gain" #Divya #LearningSkill #Knowledge #Advice #Sharing #positivity #Vibes #Information #Helpful #Thankful #Challenges
1
30
The ESOL Sewing Class is a extracurricular activity part of the ESOL Programme. The participants have been working with tutor Kate Amis on a special project for Wimbledon Lawn Tennis Museum founded by the Wimbledon Foundation. Stay tuned! #esollondon #sewinglondon #learningskill
1
198
Comment Dowm๐Ÿ‘‡๐Ÿ‘‡๐Ÿคฉ #millionairetrack #skills #skill #skilllearning #learningskill
1
3
224
The Dept.of Bioinformatics & Biosciences, CUST, organized a workshop on scientific writing on Friday, 21 October 2023 for MS, PhD, and FYP students on essential skills of scientific writing and scientific paper . #genix_cust #scientificwriting #cust #learningskill #skillset
3
103
#HClass23 broke down #OntEd Curriculum for the #LearningSkill of #SelfRegulation and put it in "kid friendly" language. We will reflect on these statements and collectively write the Progress Report next month. @SACTVDSB
1
1
15
1,879
#hishamsarwar #webdeveloper #learningskill Assalam o Alikum I am a web developer I have created an account on Upwork and Fiverr but no order or response have been received, so what should I do to get order thanks regard ,SHAHEER AHMED
2
Tonight, from 9-10pm ET, tune in to voicEd.ca for #OnEdMentors where weโ€™ll be talking about @getfocusable. #focus #attention #learningskill #tool

This Thursday, on #OnEdMentors, we welcome @Scandela9 and @blambroll to talk about their new tool to help educators and students improve their focus and remain focused. Tune in live from 9-10pm EST on voicEd.ca and follow the conversation on Twitter. #getfocusable
3
3
Handmade with love by meโค๏ธ #15000 #ASUUStrikeUpdate #learningskill #crochetbags #luxurybags
The month of January Osprey focused on #learningskill INITIATIVE. Chosen by their teachers, these students consistently demonstrate curiosity & interest in new learning with a positive mindset and a willingness to take risks. #OspreyProud #developingworkhabits @BluewaterDSB
1
3