The open-source multi-domain autonomous robot.
Walks. Runs. Flies. Swims. Fights. Thinks. Talks. Protects. Serves.
Carokia is an ambitious open-source project to build the ultimate robotic companion — a single system that combines the capabilities of every machine and creature humanity has ever engineered, into one intelligent being that stands beside you.
We believe the next frontier isn't a robot that does one thing well — it's a robot that does everything. Not a drone. Not a humanoid. Not a submarine. All of them, in one body.
Carokia aims to be:
- Multi-domain — operates on land, in air, and underwater
- Intelligent — converses, reasons, plans, learns, and adapts
- Protective — recognizes threats, guards its owner, responds to emergencies
- Capable — manipulates objects, carries loads, performs physical tasks
- Autonomous — navigates, makes decisions, and acts independently
- Loyal — always by your side, always ready
carokia/
├── brain/ # Rust workspace — AI core, decision engine, planning, perception
│ ├── crates/
│ │ ├── carokia-brain/ # Top-level orchestrator (10 Hz cognitive loop)
│ │ ├── carokia-core/ # Shared types, traits, event bus
│ │ ├── carokia-decision/ # Behavior engine, threat detection
│ │ ├── carokia-language/ # LLM backends (Ollama, Claude), conversation
│ │ ├── carokia-memory/ # Short-term + SQLite persistence, embeddings
│ │ ├── carokia-perception/ # Vision, audio, lidar, Whisper STT
│ │ ├── carokia-planner/ # Goal decomposition, task planning
│ │ └── carokia-sim/ # 2D physics simulation, ASCII renderer
│ ├── Cargo.toml # Workspace configuration
│ ├── carokia.toml # Runtime configuration
│ ├── Dockerfile
│ └── docker-compose.yml
├── body/ # Physical systems — hardware abstraction
│ ├── locomotion/ # Walking, running, crawling, climbing
│ ├── flight/ # Aerial propulsion, stabilization, navigation
│ ├── aquatic/ # Swimming, diving, underwater navigation
│ ├── manipulation/ # Arms, hands, gripping, object interaction
│ └── sensors/ # LIDAR, cameras, IMU, sonar, touch
├── guardian/ # Protection & security systems
│ ├── threat/ # Threat detection, assessment, response
│ ├── surveillance/ # Patrol, monitoring, alerting
│ └── defense/ # Physical defense, evasion, shielding
├── soul/ # Personality, emotional model, bonding
│ ├── personality/ # Character traits, behavioral patterns
│ ├── emotions/ # Emotional state modeling
│ └── bonding/ # Owner recognition, trust, loyalty
├── simulation/ # Virtual testing environments
│ ├── worlds/ # Simulation environments (land, air, water)
│ ├── scenarios/ # Test scenarios (navigation, combat, rescue)
│ └── physics/ # Physics engine integration
├── hardware/ # Hardware designs, schematics, CAD
│ ├── chassis/ # Body frame, structural design
│ ├── electronics/ # PCB designs, wiring, power systems
│ └── 3d-models/ # Printable 3D parts
├── web/ # Project website (SvelteKit)
├── learn/ # Interactive learning hub (SvelteKit)
└── docs/ # Documentation, research, references
├── vision/ # Project vision and manifesto
├── inspiration.md # 70+ reference projects catalog
├── research/ # Research papers, references
└── guides/ # Build guides, tutorials
The brain is the active development focus. It's a Rust workspace with 8 crates.
# Prerequisites: Rust, Ollama running locally
cd brain
cargo run --example chat_cli
# Or via Docker
cd brain
docker compose upSee brain/README.md for full setup and architecture docs.
| Phase | Name | Focus | Status |
|---|---|---|---|
| 1 | The Brain | AI decision engine, perception, reasoning | Active |
| 2 | The Simulation | Physics-based virtual testing | Next |
| 3 | The Body | Mobile platform — wheels, then legs | Planned |
| 4 | The Wings | Aerial capability | Planned |
| 5 | The Deep | Aquatic propulsion | Planned |
| 6 | The Guardian | Threat detection, defense, patrol | Planned |
| 7 | The Companion | Personality, emotional bonding | Planned |
| 8 | The Titan | Full integration — all domains, one body | Planned |
| Layer | Technologies |
|---|---|
| AI / Brain | Rust, Tokio, Ollama, Claude, Whisper, OpenCV |
| Web | SvelteKit 2, Svelte 5, TypeScript, Vite |
| Simulation | Gazebo / NVIDIA Isaac Sim / Unity |
| Hardware | Raspberry Pi 5, Jetson Orin, Arduino, Custom PCBs |
| Flight | PX4 / ArduPilot autopilot stack |
| Communication | gRPC, MQTT, WebSocket |
| 3D Design | FreeCAD, OpenSCAD, Blender |
This is an open-source project. We welcome roboticists, AI engineers, hardware hackers, designers, dreamers — anyone who believes a machine can be more than a tool.
See CONTRIBUTING.md for guidelines.
Apache 2.0 — Build freely. Build boldly.
"The best way to predict the future is to build it."