{"id":50658357,"url":"https://github.com/umbecanessa/babo","last_synced_at":"2026-06-08T01:04:50.128Z","repository":{"id":362079247,"uuid":"1242579447","full_name":"umbecanessa/babo","owner":"umbecanessa","description":"Persistent AI agents with memory, projects, sub-agents, and one-click WhatsApp, Telegram, Google Workspace, MCP, and ClawHub integrations.","archived":false,"fork":false,"pushed_at":"2026-06-02T13:35:00.000Z","size":6845,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-02T14:25:10.442Z","etag":null,"topics":["ai-agents","electron","nestjs","open-source"],"latest_commit_sha":null,"homepage":"https://umbecanessa.github.io/babo/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/umbecanessa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-18T14:55:24.000Z","updated_at":"2026-06-02T13:35:15.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/umbecanessa/babo","commit_stats":null,"previous_names":["umbecanessa/babo"],"tags_count":30,"template":false,"template_full_name":null,"purl":"pkg:github/umbecanessa/babo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umbecanessa%2Fbabo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umbecanessa%2Fbabo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umbecanessa%2Fbabo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umbecanessa%2Fbabo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/umbecanessa","download_url":"https://codeload.github.com/umbecanessa/babo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/umbecanessa%2Fbabo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34043826,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-07T02:00:07.652Z","response_time":124,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","electron","nestjs","open-source"],"created_at":"2026-06-08T01:04:49.457Z","updated_at":"2026-06-08T01:04:50.122Z","avatar_url":"https://github.com/umbecanessa.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Babo\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"website/assets/babo.png\" alt=\"Babo\" width=\"120\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eSelf-hosted agent OS\u003c/strong\u003e — persistent memory, projects \u0026 teams, WhatsApp · Telegram · Google.\u003cbr /\u003e\n  MIT · local-first · no telemetry · \u003ca href=\"https://babo.agency/\"\u003ebabo.agency\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/umbecanessa/babo/releases\"\u003e\u003cstrong\u003eDownload desktop\u003c/strong\u003e\u003c/a\u003e ·\n  \u003ca href=\"https://babo.agency/manifesto/\"\u003eManifesto\u003c/a\u003e ·\n  \u003ca href=\"https://babo.agency/getting-started/installation/\"\u003eDocs\u003c/a\u003e ·\n  \u003ca href=\"https://discord.gg/daCKzkv4z2\"\u003eDiscord\u003c/a\u003e\n\u003c/p\u003e\n\n**A persistent AI agent that works with you — across chat, projects, channels, and tools.**\n\nBabo is a full-stack agent platform: a desktop app, web UI, and self-hostable backend. Each agent has long-term memory, an autonomous agentic loop, project orchestration with sub-agents, and one-click integrations for the channels and tools you already use.\n\nConnect any OpenAI-compatible model (OpenRouter, Ollama, local vLLM, etc.) and run Babo on your machine or your own server.\n\n\u003e **Not just a chat UI** — Babo is an **extensible agent platform**: native skills, agent tools, and channels you can add in code (MCP, ClawHub, crystallize). Memory, board, and teams survive sessions. See the [manifesto](https://babo.agency/manifesto/) and [extension guide](https://babo.agency/extension/).\n\n---\n\n## What Babo can do\n\n### Chat with a real agent\n\n- **Streaming conversations** with live tool use, thoughts, and file proposals\n- **Agentic loop** — the agent orients, plans, calls tools, evaluates progress, and keeps going until the job is done\n- **Structured plans** — multi-step runbooks with sub-plans, acceptance criteria, and verification\n- **Slash commands** — e.g. trigger a sleep cycle to consolidate memory on demand\n- **Voice input** — speak to your agent (local or remote transcription)\n- **Embedded browser** — watch the agent browse and work in its own workspace\n\n### Projects, board, timeline \u0026 teams\n\nThe **Projects** workspace is where Babo runs serious work:\n\n| View | What you get |\n|------|----------------|\n| **Overview** | Live team orchestration, activity feed, plan progress |\n| **Board** | Kanban-style task board (Inbox, Projects, Research, Creative, custom lists) |\n| **Timeline** | Wave-based execution — see which sub-agent team is running, done, or queued |\n| **Files** | Project files and workspace artifacts |\n\nBabo can **spawn sub-agent teams** to work in parallel on plan steps. You see active teams, member progress, failures, and overall plan completion in real time — and can send hints to running delegates.\n\n### Memory that persists\n\nBabo agents don't forget between sessions:\n\n- **Cryptex** — layered long-term memory (identity, user model, project facts, skills, channels, and more)\n- **Working memory** — salience-weighted short-term slots for goals, constraints, and active context\n- **Knowledge \u0026 facts** — searchable domain memory with conflict resolution\n- **Merkle chain** — tamper-evident conversation and learning history\n- **Episodes \u0026 narrative self** — the agent builds a coherent story of your relationship over time\n- **Sleep cycles** — background consolidation turns experiences into durable memory\n\nExplore everything in the **Memory** view: overview, knowledge tree, chain, working memory, episodes, and soul.\n\n### Brain dashboard\n\nThe **Brain** page shows what your agent is \"feeling\" and doing internally:\n\n- Hormone and drive dynamics\n- Signal history (learning, bonding, reflection, and more)\n- Working memory and narrative status\n- Theory of mind — the agent's model of you\n- Network activity over time\n\nIt's the control room for a biologically-inspired runtime — useful, transparent, and optional.\n\n### Skills \u0026 one-click integrations\n\nInstall and configure capabilities from the **Tools** page:\n\n| Integration | Setup |\n|-------------|--------|\n| **WhatsApp** | Scan a QR code — connect your personal account |\n| **Telegram** | Create a bot via @BotFather; Babo walks you through it |\n| **Google Workspace** | OAuth modal — Gmail, Calendar, Drive, Sheets |\n| **Email** | Auto-provisioned agent inbox for threaded conversations |\n| **MCP servers** | Connect any MCP tool server; browse 20,000+ extensions |\n| **ClawHub** | Search and install community skills from the ClawHub registry |\n\nBundled skills include guided onboarding (QR pairing, conversational setup, or in-app OAuth). Connected MCP tools appear as first-class agent tools in the loop.\n\nAgents can also **search ClawHub**, install community skills, and **crystallize** frequently used skills into native plugins.\n\n### Built-in agent tools\n\nBeyond integrations, every agent can use:\n\n- **Browser automation** (navigate, click, snapshot, scrape)\n- **Shell \u0026 files** — read, write, search the workspace\n- **Semantic codebase search**\n- **Scheduler \u0026 HTTP pollers** — cron jobs and URL monitors\n- **Contacts** — cross-channel address book (WhatsApp, Telegram, email)\n- **Vision** — describe and ask questions about images\n- **Downloads** — offer files back to you in chat\n\n### Desktop \u0026 self-hosted\n\n- **Desktop app (Electron)** — bundles the UI + local Python runtime; first-run wizard sets up Python, inference, and backend\n- **Web UI (Angular)** — full product in the browser\n- **Backend (NestJS + PostgreSQL)** — accounts, agents, WebSocket relay, ClawHub proxy\n- **Local runtime (Python)** — agent brain, memory, tools, and FastAPI server on `127.0.0.1:9222`\n\nRun desktop-only, self-host everything, or mix cloud auth with a local runtime.\n\n---\n\n## Quick start\n\n### Desktop (recommended)\n\n**[Download the latest release](https://github.com/umbecanessa/babo/releases)** (Windows / macOS installers from CI).\n\nOr build from source:\n\n```bash\ngit clone https://github.com/umbecanessa/babo.git\ncd babo/desktop\nnpm install\n.\\build-local.ps1          # Windows: unpacked app in desktop/release-build/build-*/win-unpacked/\n# or: npm run build \u0026\u0026 npm run dist:win   # NSIS installer\n# macOS: npm run dist:mac (see desktop/BUILD-MAC.md)\n```\n\nOn first launch: set up Python, your inference URL + model (+ optional API key), and backend URL.\n\n### Self-hosted stack\n\n**1. Database + backend**\n\n```bash\ndocker compose up -d postgres\ncd backend\ncp .env.example .env   # edit secrets + RUNTIME_URL\nnpm install\nnpx prisma migrate deploy\nnpm run start:dev\n```\n\n**2. Agent runtime**\n\n```bash\npip install -r requirements-desktop.txt\nexport NLS_VLLM_BASE_URL=https://openrouter.ai/api/v1\nexport NLS_HF_MODEL=openai/gpt-4o-mini\nexport NLS_INFERENCE_API_KEY=your-key   # if needed\nuvicorn server.main:app --host 127.0.0.1 --port 9222\n```\n\n**3. Frontend**\n\n```bash\ncd frontend\nnpm install\nnpm start\n```\n\nOpen the app, register, create an agent, and start chatting.\n\nSee the [documentation](https://babo.agency/getting-started/) for full guides.\n\n---\n\n## Repository layout\n\n| Path | Role |\n|------|------|\n| `frontend/` | Angular UI — chat, projects, memory, brain, tools |\n| `backend/` | NestJS API — auth, agents, relay, ClawHub |\n| `desktop/` | Electron shell + local runtime manager |\n| `nls/` | Agent brain — memory, agentic loop, skills, tools |\n| `server/` | Python FastAPI runtime |\n\n## Documentation\n\n- **[Documentation](https://babo.agency/getting-started/)** — MkDocs site at [babo.agency](https://babo.agency/)\n- **[Documentation home](docs/index.md)** — full map (architecture, reference, extension)\n- [Deployment topologies](docs/architecture/deployment-topologies.md) — desktop hub + web relay\n- [Quickstart](docs/getting-started/quickstart.md)\n- [Extension guide](docs/extension/index.md)\n\nThe optional marketing homepage in `website/` is **not** deployed from this workflow; it can be hosted separately if needed.\n\n---\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fumbecanessa%2Fbabo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fumbecanessa%2Fbabo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fumbecanessa%2Fbabo/lists"}