Aria Code
A terminal-first AI workspace for code and research.
Work in your project, use local or cloud models, and connect domain tools when you need them.
简体中文 · English
Recorded from a real Aria Code terminal session on a temporary test fixture; idle time is shortened. This shows direct CLI commands, not an autonomous model edit. Still screenshot · Capture renderer.
What Aria Code does
Aria Code can inspect project files, propose and apply edits, run commands and tests, and explain the resulting changes. It also supports research and optional domain tools, including financial analysis and read-only warehouse operations. Those tools require their own data sources or integrations; a fresh install does not provide live business data.
The same core runtime is used by the CLI and other Aria surfaces. Model choice and tool permissions are separate: you can use a local Ollama model, configure a supported cloud provider, or sign in to the Arthera service. A cloud model or live data source needs network access.
Quick start
Requires Python 3.10 or newer. Install the CLI from PyPI and start an interactive session:
python3 -m pip install --upgrade aria-code
aria-code
If you prefer the npm launcher, use npm install -g @artheras/aria-code. For development from source, see CONTRIBUTING.md.
To use a local model, install Ollama, pull a coding model, and start Aria in local-only mode:
ollama pull qwen2.5-coder:7b
aria-code --local
Or run a single task in an existing project:
aria-code -p "Inspect this project, fix the failing tests, run them, and summarize the diff."
Aria may request approval before editing files or running commands, according to the configured permission mode. Review changes and test results before committing them.
Models and accounts
| Route | What it needs |
|---|---|
| Local Ollama | An installed and running Ollama model; no cloud account for local inference. |
| Direct cloud provider | That provider's API credentials and network access. |
| Direct Google Cloud Vertex AI | aria-code[google], Google Cloud Application Default Credentials, GOOGLE_CLOUD_PROJECT, and GOOGLE_CLOUD_LOCATION. |
| Arthera hosted service | Install aria-code[google] and sign in through /login in the CLI. Arthera account sign-in does not grant Vertex AI credentials to your own machine. |
Install extras only for features you use; see pyproject.toml for the current package options. Local inference can work offline, but live market data, remote integrations, sign-in, and cloud models cannot.
Explore the project
| Topic | Start here |
|---|---|
| Architecture and runtime | Architecture |
| Tool permissions and data boundaries | Safety notes |
| Warehouse agents and their read-only data contract | Warehouse ERP agents |
| Strategy and backtesting workflows | Strategy workspace |
| More examples | Examples |
| Releases and changes | Changelog |
For the current command-line flags, run aria-code --help. For help inside the interactive CLI, run /help. These are preferable to a copied command inventory that can drift from the product.
Contributing and license
Contributions are welcome; see CONTRIBUTING.md. Aria Code is open source under the Apache License, Version 2.0.
Releases 4.2.0 through 4.4.5 were published under the Business Source License 1.1 and remain available under those terms; releases up to and including 4.1.2 were MIT. A license grant cannot be withdrawn from someone who already has it, so each version keeps the license it shipped with — see NOTICE.
1 maintainer
Metadata
1 maintainer
Release files for aria-code 0.52.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| aria_code-0.52.0.tar.gz | 1.9 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aria_code-0.52.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 3.6 MB
Release files / aria_code-0.52.0.tar.gz
| Download URL | aria_code-0.52.0.tar.gz |
|---|---|
| Size | 1.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
96c3b9b1b032e490f4d7206a15834b980c8b9e25d9caec365755321398f1e4e0
|
|
BLAKE2b-256 checksum How to use checksums |
2b3965803d6515b90a90a296b62ad9a6cd8e37031973cd002ad25f04f02c1414
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.21 {"installer":{"name":"uv","version":"0.12.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / aria_code-0.52.0-py3-none-any.whl
| Download URL | aria_code-0.52.0-py3-none-any.whl |
|---|---|
| Size | 1.8 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
83a1aa61a3a24e50b82e1bf6158ff0086c159fa5be0322814fde2da7dc0e8305
|
|
BLAKE2b-256 checksum How to use checksums |
d8269dc4210422a401aec246a78a959ba90cc76c519b42e7c74e81f42b7ac8e6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.21 {"installer":{"name":"uv","version":"0.12.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
