# entheai

> entheai is a personal, macOS/Apple-Silicon, terminal-native hybrid coding agent written in Rust — a cloud orchestrator plans, then fans out to model-matched sub-agents that build in parallel and merge back verified.

## Overview

- [What is entheai](https://entheai.com/docs/#what-is): entheai is a personal, macOS/Apple-Silicon native hybrid coding agent written in Rust — and an automated quantum simulation playground where prompt states continuously morph fluid fields of infinite entropy back and forth into rigid, binary singularity checkpoints.
- [Hybrid brain & fan-out](https://entheai.com/docs/#concept): The core design of entheai bridges the fluid entropy of prompt states with the rigid determinism of compiled checkpoints.
- [Who it's for](https://entheai.com/docs/#who): entheai is built for solo developers and engineers on Apple Silicon Macs who require a personal, terminal-native hybrid coding agent that: - Respects Local & Keyless Compute: Operates out-of-the-box with zero setup using keyless community nodes (coder.vaked.dev) or local Osaurus inference without sending tokens to cloud APIs.

## Getting started

- [Install & build](https://entheai.com/docs/#install): entheai is native to macOS on Apple Silicon (aarch64-apple-darwin).
- [Configure entheai.toml](https://entheai.com/docs/#configure): entheai reads entheai.toml from the current working directory.
- [First run](https://entheai.com/docs/#first-run): Start using entheai out-of-the-box with zero API key configuration by connecting to the free community node on coder.vaked.dev: Troubleshooting Startup Limits - Headless / No-TTY Execution: If launched without an interactive terminal (e.

## Configuration

- [Providers](https://entheai.com/docs/#providers): entheai communicates with any OpenAI-compatible API backend via adk-rust.
- [Models & ids](https://entheai.com/docs/#models): Every model spec in entheai follows the <provider>/<model> convention: Resolution Mechanics 1.

## Concepts

- [The agent loop](https://entheai.com/docs/#loop): The core execution engine (crates/core) is powered by EntheaiAgent, wrapping [adk-rust](https://github.
- [The tiered router](https://entheai.com/docs/#router): The tiered router (crates/router) resolves task requirements to the optimal model tier based on role, cost, and complexity.
- [Fan-out & roles](https://entheai.com/docs/#fanout): When invoked with entheai --fanout "<task>", the orchestrator plans, section-maps the input via entheai-mapper, and fans out execution across parallel sub-agents operating in isolated git worktrees (.worktrees/).
- [Permission gate & YOLO](https://entheai.com/docs/#permissions): All side-effecting tool calls pass through entheai-permission.
- [Memory namespaces](https://entheai.com/docs/#memory): entheai manages memory across five dedicated SQLite + vector namespaces (entheai-memory): | Namespace | Description | |---|---| | codebase | Codebase structure — symbol indexing, call graph, and architecture.
- [Skills · plugins · MCP](https://entheai.com/docs/#extend): entheai provides three extensibility vectors: 1.

## The visual TUI

- [Visual TUI & Zen field](https://entheai.com/docs/#tui): The interactive TUI (crates/tui) runs on ratatui with responsive canvas rendering: Core Visual Features - Brain Panel (/brain): A rotating braille 3D pseudo-graph representing model, tools, context, and fleet node presence.
- [Companion, Radio & Speak](https://entheai.com/docs/#companion-radio): Peripheral integrations that run concurrently with the terminal session: 1.
- [Gallery](https://entheai.com/docs/#gallery): entheai is visual by design — built on ratatui with braille 3D projections, custom color-harmony themes, and dynamic telemetry streams over NATS.

## Architecture

- [Crate map & system](https://entheai.com/docs/#arch): entheai is structured as a modular Rust workspace (resolver v2) compiled for Apple Silicon (aarch64-apple-darwin): Binary Distribution & Release Profiles - PGO Release (scripts/build-release.sh): opt-level=3, lto="fat", codegen-units=1, target-cpu=native, mimalloc allocator.

## Roadmap

- [Roadmap & Stability](https://entheai.com/docs/#roadmap): entheai has reached v1.