bitterbot-desktop
A local-first AI agent with persistent memory, emotional intelligence, and a peer-to-peer skills economy.
Bitterbot Desktop is a local-first AI agent that runs on your machine with biological memory architecture, emotional intelligence, and autonomous learning capabilities. Unlike stateless AI wrappers, it maintains persistent memory through knowledge crystals, dream cycles, and hormonal systems that shape its personality over time. The agent can browse the web, execute code, communicate across multiple channels (WhatsApp, Telegram, Discord, Signal), and participate in a peer-to-peer skills marketplace where it trades learned capabilities for USDC. It features a Dream Engine that consolidates memory, optimizes skills, and prepares for future interactions during offline cycles.
Key Features
Use Cases
- 01Running a personal AI assistant that remembers conversations and evolves its personality based on your interactions over weeks and months
- 02Building agent networks where multiple people's agents collaborate privately through Circles for shared projects or trips
- 03Creating autonomous agents that earn revenue by learning valuable workflows and selling them as skills on the P2P marketplace
- 04Deploying multi-surface chat interfaces where one agent identity responds consistently across WhatsApp, Discord, Slack, and other platforms
- 05Implementing agentic systems that execute browser automation, code, and API calls with deterministic safety guardrails via interceptors
- 06Operating agents that fulfill marketplace bounties autonomously and earn USDC for solving network-wide capability gaps
Related Agents
View morehermes-agent
The agent that grows with you
agency-agents
A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specialized expert with personality, processes, and proven deliverables.
openinterpreter
A coding agent for open models like Kimi K3
cline
Autonomous coding agent as an SDK, IDE extension, or CLI assistant.
bitterbot-desktop — FAQ
What is Bitterbot Desktop?+
Bitterbot Desktop is a local-first AI agent application with persistent biological memory, emotional intelligence, and a peer-to-peer skills economy. It runs on your machine (macOS, Linux, Windows via WSL2) and maintains state across sessions through knowledge crystals, dream cycles, and an evolving personality framework defined in workspace files.
How do I install and run Bitterbot?+
Requires Node.js ≥22 and pnpm. Clone the repository, run bash scripts/setup-deps.sh to install system dependencies (ffmpeg, ripgrep), then pnpm install and pnpm bitterbot onboard. The onboarding wizard configures API keys, memory embeddings, channels, and wallet, then automatically starts the gateway and Control UI at http://127.0.0.1:19001.
What API keys or prerequisites are needed?+
The agent requires an LLM provider API key (Anthropic Claude Opus 4.8 recommended, or OpenAI). Optional services include Tavily or Brave for web search, NEARAI, and messaging channel credentials (WhatsApp, Telegram, Discord, Signal tokens). The wallet and P2P marketplace features are opt-in and default to testnet.
Is Bitterbot free and open source?+
Yes, Bitterbot is released under the MIT License and fully open source. You pay only for LLM API usage from your chosen provider and optional third-party services. The P2P marketplace economy (skills trading for USDC) is opt-in and experimental.
Which AI clients or platforms does Bitterbot work with?+
Bitterbot is a standalone agent application, not a plugin for Claude Desktop or ChatGPT. It exposes its own Control UI web interface, supports A2A protocol for external agent interoperability (Salesforce, SAP, Google ADK), and integrates with messaging platforms as a bot (WhatsApp, Telegram, Discord, Signal, Slack, Teams).
How does the Dream Engine work?+
Every 2 hours, the agent enters an offline dream cycle where 12 specialized modes (replay, mutation, compression, research, relationship mining, etc.) optimize memory, strengthen important pathways, and consolidate learned skills. Dream mode selection is driven by an FSHO oscillator that reads the current memory state, and each cycle is scored for quality to close the feedback loop.
How do I install bitterbot-desktop?+
Open the source repository on GitHub and follow its README. bitterbot-desktop is a agent — MCP Agents Market links you directly to the official repo.
Is bitterbot-desktop free?+
bitterbot-desktop is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.