>OPEN SOURCE CODING AGENT

Nanocoder

An open coding agent for your terminal, built by a community collective rather than a company. Bring your own model, keep your code on your machine, and owe nothing to anyone.

█▄ █ ▄▀█ █▄ █ █▀█ █▀▀ █▀█ █▀▄ █▀▀ █▀█
█ ▀█ █▀█ █ ▀█ █▄█ █▄▄ █▄█ █▄▀ ██▄ █▀▄
✱ Welcome to Nanocoder 1.0.0
Tips for getting started:
1. Use natural language to describe what you want to build.
2. Ask for file analysis, editing, bash commands and more.
3. Be specific as you would with another engineer for best results.
4. Type /exit or press Ctrl+C to quit.
/help for help
Ollama·gemma4:12b·~/Library/Preferences/nanocoder/agents.config.json·⎇ main (default)
What would you like me to help with?
normal mode on · ctx: ~1%
2.3kGitHub Stars
76Contributors
249Forks
1.3kCommunity

The open alternative.

Nanocoder is a community-built, multi-provider coding agent that runs entirely in your terminal. It connects to Ollama for local execution, or OpenRouter, Anthropic, OpenAI, and Google for cloud inference.

Built by the Nano Collective rather than a company, it enforces a strict privacy-first model: your codebase never leaves your machine unless you explicitly send it to an API of your choice. No tracking, no forced telemetry, no vendor lock-in.

Premium capabilities.
Zero paid tiers.

Local First

Runs entirely on your machine. Connect to local Ollama models for completely offline, zero-cost agentic coding.

Multi Provider

Seamlessly switch between OpenRouter, Anthropic, OpenAI, and Google. You choose the intelligence engine.

Skills System

Extend behavior through custom skills. Teach Nanocoder your codebase's exact conventions and workflows.

Custom Tools

Create and integrate your own Bash or Python tools directly into the agent's toolbelt.

Multiple Modes

Boot directly into Normal, Plan, Auto-Accept, or YOLO mode depending on your trust level for the task.

Open Source

Built in public by contributors. The codebase is yours to read, audit, and improve.

Privacy First

No forced telemetry. No silent data collection. Complete control over what leaves your network.

Terminal Native

Designed explicitly for terminal workflows. Fits seamlessly into your existing developer environment.

Realistic workflows.

Nanocoder handles architecture, refactoring, and feature building natively in your terminal.

Refactor
$ nanocoder run "refactor database module"
⚒ read_file
Path: src/db/users.ts
⚒ string_replace
12 - await sql("SELECT * FROM users")
12 + await db.user.findMany()
⚒ execute_bash
Command: npm run typecheck
● exit 0
Refactored 12 queries across 2 files
Audit
$ nanocoder --mode plan run "audit auth module"
⚒ read_file
Path: src/auth/jwt.ts
⚙ Thought
Reviewing token expiry and login throttling.
1. Verify JWT expiration logic
2. Check password hashing rounds
3. Audit rate limiting on /login
⚠ No rate limiter on POST /login
Waiting for approval...
Build
$ nanocoder run "create settings page"
⚒ write_file
Path: app/settings/page.tsx
Size: 84 lines, ~1.2k chars
⚒ write_file
Path: components/SettingsForm.tsx
⚒ execute_bash
Command: npm test
● exit 0
Created 2 files · 14 tests passed

Install in seconds.

Zero complex setup. Available on your favorite package manager.

NPM
npm install -g @nanocollective/nanocoder
Homebrew
brew tap nano-collective/nanocoder https://github.com/Nano-Collective/nanocoder brew install nano-collective/nanocoder/nanocoder
Nix Flakes
nix run github:Nano-Collective/nanocoder

Why developers choose Nanocoder

100% Open Source

Read the code. Audit the code. Improve the code. It belongs to the community, not a corporation.

Local Architecture

Designed from the ground up to run inference locally, ensuring maximum privacy and zero latency costs.

Bring Your Own Model

Plug in any compatible local model, or route through the APIs you already pay for.

Zero Vendor Lock-In

If you don't like Nanocoder, you can uninstall it. Your project history and Git tree remain completely untouched.

Community Driven

Features are built based on what developers actually need, not what looks good in a marketing pitch.

Highly Extensible

A robust plugin ecosystem means you can tailor the agent perfectly to your unique tech stack.

Supported by

Sponsorship funds the people building open, privacy-respecting AI tools, and keeps every line of it free at the point of use.

Become a sponsor
[ Join the Collective ]

Build with us.

Join developers building the future of local-first AI tooling.