Too lazy for prompts. Built a brain instead.
Start Here
Pick your path — each one gets you to an “aha” moment in 15 minutes or less.
| You are… | Start with… | Time |
|---|---|---|
| An AI/agent builder | Cognitive Agent Quickstart | 15 min |
| A Ruby developer | Extension Dev Quickstart | 10 min |
| An LLM power user | Multi-Provider Routing Guide | 10 min |
| Evaluating for enterprise | Enterprise Overview | 5 min read |
| Ready to contribute | Contributing Guide | 5 min read |
The Cognitive Stack
Every LegionIO agent runs a tick cycle — a 13-phase cognitive loop modeled on biological neural processing. Each tick, the agent perceives, remembers, predicts, decides, acts, and reflects. During idle periods, a 7-phase dream cycle consolidates and reorganizes memory.
flowchart LR
subgraph TICK["Waking Tick Cycle"]
direction LR
A["Sensory\nProcessing"] --> B["Emotional\nEvaluation"]
B --> C["Memory\nRetrieval"]
C --> D["Knowledge\nRetrieval"]
D --> E["Identity\nEntropy Check"]
E --> F["Working Memory\nIntegration"]
F --> G["Procedural\nCheck"]
G --> H["Prediction\nEngine"]
H --> I["Mesh\nInterface"]
I --> J["Gut\nInstinct"]
J --> K["Action\nSelection"]
K --> L["Memory\nConsolidation"]
L --> M["Post-Tick\nReflection"]
end
subgraph DREAM["Dream Cycle"]
direction LR
D1["Memory\nAudit"] --> D2["Association\nWalk"]
D2 --> D3["Contradiction\nResolution"]
D3 --> D4["Agenda\nFormation"]
D4 --> D5["Consolidation\nCommit"]
D5 --> D6["Dream\nReflection"]
D6 --> D7["Dream\nNarration"]
end
234 cognitive modules across 13 domain gems — memory, emotion, attention, inference, social cognition, metacognition, imagination, and more. Every module is optional, composable, and independently removable.
See It in Action
$ legion start
Loading 73 extensions... done
Tick cycle: 13 phases active
Dream cycle: standby
API: http://localhost:4567
Ready.
$ legion chat
You: Tell me about yourself
Agent: I'm a LegionIO cognitive agent. I have memory that fades,
predictions that adapt, and I dream during idle periods
to consolidate what I've learned. What would you like
to explore?
45 seconds from install to your first conversation with an agent that thinks.
Community
- GitHub Discussions — questions, ideas, architecture talk
- Slack — real-time chat
- Philosophy — understand our design principles before contributing
- Extension Catalog — browse all 73 extensions
Quick Install
# Homebrew (recommended)
brew tap LegionIO/tap
brew install legionio
# Or RubyGems
gem install legionio
# Start the engine
legion start
# Or just chat
legion chat
Requirements: Ruby >= 3.4, RabbitMQ. Optional: PostgreSQL/MySQL/SQLite, Redis/Memcached, HashiCorp Vault.
| License: Core framework Apache-2.0 | Extensions MIT |