# Bumblebee

## Docs

- [Agents overview](https://docs.bumbleagi.com/agents/overview.md): One persistent entity, one harness — many ways to show up.
- [Worker runtime](https://docs.bumbleagi.com/agents/worker.md): Headless `bumblebee worker` — platforms and daemon without the CLI.
- [Autonomous wake & poker prompts](https://docs.bumbleagi.com/architecture/autonomous-wake.md): Self-initiated perceive cycles, sustained sessions, wake voice, YAML seed decks, GEN-grounded disposition, body-driven auto-escalation, and visibility.
- [Cognition](https://docs.bumbleagi.com/architecture/cognition.md): The perceive pipeline, agent loop, and context compaction.
- [GEN / noise pipeline](https://docs.bumbleagi.com/architecture/gen-noise-pipeline.md): End-to-end data flow for Generative Entropic Noise — inputs, triggers, events, generation behavior, mood congruence, and autonomous web venturing.
- [Identity](https://docs.bumbleagi.com/architecture/identity.md): Personality engine, character voice, and trait evolution.
- [Memory](https://docs.bumbleagi.com/architecture/memory.md): Episodic narratives, relationships, beliefs, procedural skills, and self-narrative.
- [Architecture overview](https://docs.bumbleagi.com/architecture/overview.md): The five pillars of Bumblebee's design.
- [Presence](https://docs.bumbleagi.com/architecture/presence.md): Always-on daemon, initiative, wake cycles, and multi-platform adapters.
- [Soma](https://docs.bumbleagi.com/architecture/soma.md): Tonic body state — drives, layered affects, impulses & conflicts (including near/brewing), GEN, somatic appraisal, ebb, and body.md.
- [Building on Bumblebee](https://docs.bumbleagi.com/build/overview.md): Extension points for entities, tools, presence, and inference.
- [Portable inference](https://docs.bumbleagi.com/build/portable-inference.md): Gateway, remote provider, and routing home GPU through external systems.
- [Presence & social surfaces](https://docs.bumbleagi.com/build/presence-and-social.md): Telegram, Discord, CLI — how social adapters plug into one entity.
- [Gateway](https://docs.bumbleagi.com/deployment/gateway.md): The home inference gateway for hybrid deployments.
- [Hosted inference (testing)](https://docs.bumbleagi.com/deployment/hosted-inference-testing.md): Optional OpenRouter and Venice AI for product-style harness evaluation—same open codebase, no change to local-first defaults.
- [Hybrid Railway](https://docs.bumbleagi.com/deployment/hybrid-railway.md): Run inference at home, entity on Railway with Postgres.
- [Local deployment](https://docs.bumbleagi.com/deployment/local.md): Run everything on one machine with Ollama.
- [Persistence](https://docs.bumbleagi.com/deployment/persistence.md): Volume, Postgres, and data durability on Railway.
- [FAQ](https://docs.bumbleagi.com/faq.md): Common questions about running Bumblebee.
- [Automations](https://docs.bumbleagi.com/guides/automations.md): Scheduled routines, emergence, and journal integration.
- [Creating entities](https://docs.bumbleagi.com/guides/creating-entities.md): Define a new entity with the wizard or YAML.
- [Discord](https://docs.bumbleagi.com/guides/discord.md): Run your entity as a Discord bot.
- [Knowledge and journal](https://docs.bumbleagi.com/guides/knowledge-and-journal.md): Durable facts and private reflections for your entity.
- [Personality and voice](https://docs.bumbleagi.com/guides/personality-and-voice.md): Shape who your entity is — traits, voice, backstory, and drives.
- [Telegram](https://docs.bumbleagi.com/guides/telegram.md): Connect your entity to a Telegram bot.
- [Tools](https://docs.bumbleagi.com/guides/tools.md): Built-in tools, MCP integration, and extending the stack.
- [Introduction](https://docs.bumbleagi.com/index.md): Gemma 4–native agent harness for local assistants and persistent entities—run on your hardware, no hosted inference by default.
- [Setup & onboarding](https://docs.bumbleagi.com/onboarding.md): Guided `bumblebee setup` and `bumblebee gateway setup` — hybrid stack, Railway, Cloudflare Tunnel, and health checks.
- [Quickstart](https://docs.bumbleagi.com/quickstart.md): Install Bumblebee and talk to your first entity in five minutes.
- [CLI reference](https://docs.bumbleagi.com/reference/cli.md): Every bumblebee command and its flags.
- [Configuration](https://docs.bumbleagi.com/reference/configuration.md): Harness defaults and entity YAML reference.
- [Environment variables](https://docs.bumbleagi.com/reference/environment-variables.md): Every BUMBLEBEE_* and platform variable.
- [Hardware](https://docs.bumbleagi.com/reference/hardware.md): GPU VRAM requirements and model sizing.

## OpenAPI Specs

- [openapi](https://docs.bumbleagi.com/api-reference/openapi.json)