bhxtnx/SelfAgent
🤖 Build a self-hosted AI assistant to manage files, browse web, write code, and chat via a WhatsApp-style interface using your own API keys.
What's novel
🤖 Build a self-hosted AI assistant to manage files, browse web, write code, and chat via a WhatsApp-style interface using your own API keys.
Code Analysis
15 files read · 4 roundsA local AI agent framework that connects to multiple LLM providers (OpenAI, Anthropic, Google, Ollama) via raw httpx, runs an iterative tool-use loop with 20+ tools (browser automation, terminal, email, scheduling, file management), and serves a WebSocket chat UI via FastAPI.
Strengths
Clean architecture with proper separation of concerns (core agent loop, provider adapters, tool registry, layered memory), thoughtful provider fallback logic for free models, and genuinely functional tool implementations (Playwright browser, persistent terminal sessions, IMAP/SMTP email with markdown conversion, cron scheduling).
Weaknesses
The README is heavily marketing-oriented and references a downloadable zip that doesn't exist in the repo, making it misleading; test coverage is thin (only 5 test files for 117 source files) and the scheduler's cron implementation polls every 30 seconds rather than computing next-fire times, which is imprecise.
Score Breakdown
Signal breakdown
Innovation
Craft
Traction
Scope
Evidence
Commits
5
Contributors
1
Files
74
Active weeks
2
Repository
Language
Python
Stars
1
Forks
0
License
MIT