Tiny Claw aims to democratize AI agents by offering a personal, autonomous companion that is simple, affordable, and truly personal, contrasting with the complexity and cost of existing frameworks. It targets individual users seeking a helpful AI friend rather than an enterprise tool, promising an AI experience akin to the personal computer revolution.

How It Works

Tiny Claw is a native framework built from scratch with a minimal core and an extensible plugin architecture. Its design emphasizes affordability and autonomy through features like self-improving memory with temporal decay, smart query routing to tier LLM usage and cut costs, and a personality engine (Heartware) that gives the agent its own character. It leverages Bun for high performance and a SQLite database for persistence, aiming for a zero-hassle, self-configuring setup.

Quick Start & Requirements

• Install: bun install
• Run: bun start
• Access: Open http://localhost:3000 in your browser.
• Prerequisites: Bun runtime. Uses Ollama Cloud with built-in models (kimi-k2.5:cloud, gpt-oss:120b-cloud) by default.
• Development: bun dev for hot-reloading.
• Links: No external quick-start or demo links provided; setup is guided locally.

Highlighted Details

• Discord-like web UI with real-time SSE streaming.
• Adaptive Memory system with episodic, semantic (FTS5), and temporal decay components.
• Self-improving agent capable of learning from interactions.
• Plugin architecture for channels, providers, and tools, keeping the core minimal.
• Heartware Personality engine with SOUL.md and IDENTITY.md.
• Smart Routing classifier to optimize LLM costs by tiering queries.
• 4-layer Context Compactor pipeline.
• Built-in SHIELD.md anti-malware enforcement and 5-layer security.
• Delegation System for autonomous sub-agent orchestration.
• Bun-native runtime for performance and minimal footprint.
• Multi-provider support (Ollama, OpenAI, Anthropic) with automatic fallback.

Maintenance & Community

The project is under active development, with warnings to wait for the first official release. Updates can be followed on X (@TinyClawAI, @warengonzaga). Support is encouraged via GitHub Sponsors or Buy Me a Coffee. A Code of Conduct is available.

Licensing & Compatibility

Licensed under the GNU General Public License v3.0 (GPLv3). This strong copyleft license may impose restrictions on use within closed-source or commercial applications.

Limitations & Caveats

The project is explicitly marked as "Under Active Development" with a warning that "things will break" and users should wait for the first official release to avoid a potentially spoiled experience. There is no official cryptocurrency token associated with the project.