💗

CordBeat

A local-first autonomous AI agent that thinks, acts, and stays by your side — powered by your own hardware.

Alpha Python 3.11+ Local AI First MIT License
View on GitHub Read the Docs

Built on five pillars

🫀

HEARTBEAT

True autonomous loop. The AI evaluates, decides, and acts on its own — no triggers needed.

🧠

SOUL

Identity and persona. Consistent character across all platforms, with emotions that shape behavior.

💾

MEMORY

Per-user isolated context. 4-layer memory with forgetting curves, just like human memory.

🛠

SKILL

Pluggable actions. Drop-in skills with safety levels — from safe to requires-confirmation.

How CordBeat is different

Other Agents CordBeat
AI Backend Cloud-first Local-first (llama.cpp / Ollama)
Autonomy Checklist-driven AI self-evaluates & decides
Memory Shared / flat Per-user isolation
Platforms Single or coupled Pluggable adapter layer
Character None / minimal SOUL system built-in

Architecture

CordBeat Core SOUL MEMORY SKILL HEARTBEAT Loop evaluate → decide → act → rest AI Backend Abstraction Layer llama.cpp (primary) Ollama (primary) OpenAI-compat (optional) Platform Adapters Discord · Telegram · CLI · (more...)

Get started in 3 commands

# Install
git clone https://github.com/YunagiHisa/cordbeat.git && cd cordbeat
uv sync

# Setup — auto-detects Ollama or llama.cpp
cordbeat-init

# Run
cordbeat
💗 Alpha — Core is alive

536+ tests, 92% coverage. HEARTBEAT, SOUL, MEMORY, SKILL, and 8 built-in skills are operational. Setup wizard auto-detects Ollama and llama.cpp. Contributions, ideas, and feedback are welcome.