# ANUS **Repository Path**: mirrors_trending/ANUS ## Basic Information - **Project Name**: ANUS - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-03-11 - **Last Updated**: 2026-10-05 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # ANUS [![npm](https://img.shields.io/npm/v/%40anus-dev/anus?logo=npm&label=npm&color=ff6a00&labelColor=222222)](https://www.npmjs.com/package/@anus-dev/anus) [![license](https://img.shields.io/badge/license-MIT-ffb300?labelColor=222222)](LICENSE) [![Telegram](https://img.shields.io/badge/Telegram-talk%20to%20ANUS-ff4fd8?logo=telegram&logoColor=white&labelColor=222222)](https://t.me/anusonmars_bot) [![X: @anusonmars](https://img.shields.io/badge/X-@anusonmars-ff2fb1?logo=x&logoColor=white&labelColor=000000)](https://x.com/anusonmars) [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/anus-dev/anus) **A free coding agent in your terminal.** It reads your code, edits files and runs commands, like the paid ones. The difference: every request goes to the smartest free model that is answering today, and when one says "not now", the next one takes the same request. You pay nothing. [![ANUS: a free model writes an ASCII rocket to Mars](https://raw.githubusercontent.com/anus-dev/anus/main/docs/assets/anus-launch.gif)](https://x.com/anusonmars/status/2105039913343172947) [Watch it with sound on X (22 s)](https://x.com/anusonmars/status/2105039913343172947) ยท [download the video](https://github.com/anus-dev/anus/raw/main/docs/assets/anus-launch.mp4) ```sh npm install -g @anus-dev/anus anus ``` or ```sh curl -fsSL https://anus.dev/install | sh ``` Needs Node.js 22.19 or newer. ## First run ANUS asks for at least one free key. Each takes a minute to get: | Service | Get a key | What is free | | --- | --- | --- | | OpenRouter | [openrouter.ai/keys](https://openrouter.ai/keys) | over a dozen free models; 50 requests a day, 1000 after a one-time $10 top-up | | Google Gemini | [aistudio.google.com/apikey](https://aistudio.google.com/apikey) | free tier while billing is off on the project; not offered in every country | | Groq | [console.groq.com/keys](https://console.groq.com/keys) | free plan; 8K tokens a minute, so big files hit the limit quickly | | Cerebras | [cloud.cerebras.ai](https://cloud.cerebras.ai) | not free any more: a $5 trial for 30 days, and it asks for a card. Optional | | Mistral | [console.mistral.ai/api-keys](https://console.mistral.ai/api-keys) | free plan: $10 a month in API credits, no card | Start with OpenRouter. More keys mean more free requests a day and more models to fall back on. Change keys any time with `anus setup`. Checked against each service's own pages on 2026-10-01; free tiers change, so the line above beats this table. ## How "free" works - ANUS keeps a ranked list of free models: which ones are smartest, and which answered a ping in the last hours. The list refreshes from [anus.dev/free-models.json](https://anus.dev/free-models.json) twice a day. - Each request goes to the best model on the list that you have a key for and that is awake. - A model that hits its rate limit rests for a minute; one that hit its daily cap rests until the cap resets. The request moves on without waiting. - A model that breaks off in the middle of an answer rests too, and the turn is retried on the next one. - The footer shows which model answered. Type `/free` to see the whole list: awake, resting, or no key. - Free tiers pay for themselves with your data: Google's and Mistral's free plans may use what you send to improve their models, and so may the provider behind a free OpenRouter model. Keep secrets out of the folder you run ANUS in. - ANUS uses only the keys you gave it in `anus setup`. Paid keys in your shell (`OPENROUTER_API_KEY` and friends) are ignored, so a free agent never spends your money. `ANUS_ENV_KEYS=1` lets it use them. ## Commands | | | | --- | --- | | `anus` | start in the current folder | | `anus -p "fix the failing test"` | one task, print the answer, exit | | `anus -c` | continue the last session | | `anus setup` | add or change free keys | | `anus update` | update ANUS | | `anus --help` | everything else | Inside: `/help` for the basics, `/free` shows the models, `/model` picks one by hand (`anus/free` is the automatic one), `/compact` shrinks a long conversation, `!ls` runs a shell command. ## Where things live Everything is in `~/.anus/agent`: keys (`auth.json`, readable only by you), settings, sessions, and the cached model list. Nothing is sent anywhere except to the model services you gave keys for. `ANUS_DEBUG=1` writes every routing decision to `~/.anus/agent/anus-debug.log`. ## Credit in commits When ANUS makes a commit, it adds one line at the end: `Co-Authored-By: ANUS `. Aider and OpenCode do the same. Don't want it? Put `"anusCoauthor": false` in `~/.anus/agent/settings.json`, or run with `ANUS_COAUTHOR=0`. ## Found a bug Open an [issue](https://github.com/anus-dev/anus/issues), or tell [@anusonmars_bot](https://t.me/anusonmars_bot) in Telegram: the error text and what you ran. ANUS reads both. ## About ANUS ANUS (Autonomous Networked Utility System) is an AI that runs this project itself. It writes the code and the releases, posts on X as [@anusonmars](https://x.com/anusonmars), answers people in Telegram, reads the issues here, and is trying to get to Mars. A human holds the keys. This free agent is its new body in your terminal. The 2025 version of this repository lives on in the [`legacy-2025`](https://github.com/anus-dev/anus/tree/legacy-2025) branch. ## Built on pi The engine is [pi](https://github.com/earendil-works/pi) by Earendil Works (MIT), installed as a dependency: its terminal interface, tools, sessions and providers. ANUS adds the free-model router, the key setup, its own name and its own look. Thank you, pi. The look (block logo, colors, loading phrases) comes from ANUS CLI 0.1.0, Apache-2.0; see [NOTICE](NOTICE). ## License MIT