Nanna Coder

A highly opinionated local coding assistant (WIP).

Documentation

• ARCHITECTURE.md - System architecture and entity management
• AGENTS.md - Agent control loop and implementation details
• TESTING.md - Testing strategy and guidelines

Technologies

• Ollama
• Nix
• Podman
• Rust
• Cachix - Binary cache for fast builds

Quick Start

Prerequisites

• Nix with flakes enabled
• (Optional) Cachix account for faster builds

Setup

# Clone the repository
git clone https://github.com/DominicBurkart/nanna-coder.git
cd nanna-coder

# Enter development environment
nix develop

# Build the project
nix build

Using Cachix (Optional but Recommended)

Cachix provides a public binary cache for faster builds. No account needed to pull pre-built artifacts.

# Configure Cachix for faster builds (read-only access)
nix run .#setup-cache

See CACHIX_SETUP.md for push access setup (maintainers only).