Skip to main content

Aria Code icon

Aria Code

An open-source AI agent for coding, financial analysis and logistics operations.
Numbers you can check, client data kept apart, actions a person approves.

简体中文 · English

npm version PyPI version CI status Apache License 2.0

Real Aria Code session: Gemini 2.5 Pro writes fx.py and its tests, runs them after each step is approved, then /review checks the change

A real session on Gemini 2.5 Pro (Vertex AI): Aria writes fx.py and its tests, runs them once each step is approved, then /review checks the change and gives its verdict. Waiting is shortened; nothing else is changed. Still · Recorder · Renderer

What Aria Code does

Writes code and builds projects. Describe the task in plain words. Aria reads the project, writes and edits files, runs commands and tests, and shows every change before it lands — nothing is written or run until you say yes. /review reviews a change the way a careful colleague would: prioritised findings (P0–P3) with file and line, and a verdict; aria-code review --base main --fail-on P1 gates a pull request in CI. Use a local Ollama model, Gemini on Google Cloud (Vertex AI, with nothing more than a gcloud login), or another supported provider.

Analyses markets and finances. Quotes, technical indicators, backtests with an HTML report, risk and factor analysis, SEC filings, and US, Hong Kong, A-share and crypto data. Results name their data source, period and any gaps.

Real Aria Code session: technical indicators for AAPL and a one-year momentum backtest on SPY, with data source, period and completeness stated

Runs logistics operations. For third-party logistics: reorder points, safety stock, ABC/XYZ classes, dead stock, carrier scorecards and freight anomalies — and in Feishu, a daily digest per shipper with approval cards.

Real Aria Code session: a refusal to mix two shippers' data, reorder points for one shipper, and a carrier scorecard with a saving and two anomalies

Both recorded from real sessions — market data from yfinance; the logistics data is the sample 3PL in evals/fixtures, with no model call.

How it works

A general-purpose assistant aims for an answer that reads well. In code, markets and warehouses the result gets acted on — a rounding rule in a currency function, one purchase order left out of a reorder quantity. Three rules follow from that.

Numbers you can check. Reorder points, safety stock, carrier rankings and backtests come from stated formulas and named data, with the formula and every assumption in the result — as does stablecoin settlement reconciliation, from the Artheras skills Aria Code can install. When the data cannot support an answer — under 14 days of demand history, rows that name no shipper — it says so instead of estimating. The operations eval suite checks exactly these traps.

Client data kept apart. A third-party logistics provider holds many clients' stock side by side. A chat group bound to one shipper confines every analysis to that shipper, and the logistics tools themselves refuse another shipper's data or an unattributable file — the rule holds below the prompt, whatever the model asks for.

Actions a person approves. In the terminal, every file write and command waits for your yes, with the diff in front of you. In Feishu, /补货 turns the reorder list into a purchase-order draft card; nothing happens until an authorised approver presses approve, and what runs is exactly what was shown. The draft is a file for your own purchasing system — Aria Code places no orders.

A fresh install has no live business data: the logistics tools read your exports (CSV or JSON), market data comes from public sources, and the chat features need a Feishu app or the Aria relay.

Quick start

Install the standalone CLI on macOS or Linux without Python, Node.js, or npm:

curl -fsSL https://raw.githubusercontent.com/artheras/aria-code/main/scripts/install.sh | sh
~/.local/bin/aria

On Windows x64, run this in PowerShell:

irm https://raw.githubusercontent.com/artheras/aria-code/main/scripts/install.ps1 | iex
aria

The installer downloads the binary for your OS from the latest GitHub release, checks its SHA-256 digest, and installs it in your user account. Open a new terminal to start the interactive CLI with aria, aria code, or aria-code. Set ARIA_CODE_VERSION=v0.55.0 to pin a release.

Alternative package-manager installs: npm install -g @artheras/aria-code (requires npm) or python3 -m pip install --upgrade "aria-code<4" (requires Python 3.10+; the <4 skips an older 4.x numbering that PyPI still lists). For development from source, see CONTRIBUTING.md.

The pip base install supports coding and chat without the financial data stack. Add it with python3 -m pip install "aria-code[finance]<4"; full, all, and dev retain finance dependencies. Native/npm releases retain their bundled financial tools. See optional finance installation.

Updates

Aria checks for a newer stable version in the background at startup, at most once per day. Cached notices appear immediately; network checks never delay the prompt. It checks GitHub Releases, or scoped npm for npm installs. Pip updates pin the GitHub version and verify that version is available on PyPI, avoiding the older 4.x numbering still listed as PyPI's latest. Source checkouts receive Git update instructions.

aria update --check  # check without installing
aria update          # install the newest stable version for this install channel
aria update --to 0.110.0  # choose a specific stable release
aria update --rollback   # native macOS/Linux: restore the previous managed release offline

In an interactive session, use /update --check or /update, then restart Aria. Native updates verify SHA-256 and the downloaded binary's version before switching the command; a failed download or verification leaves the existing command in place. Startup checks only notify. To disable them, set check_for_update_on_startup to false in ~/.aria-code/config.json.

For GitHub notifications, open this repository, select Watch → Custom → Releases, and save. Notifications follow your GitHub notification settings. Published stable releases appear on the release page once the platform assets and package publishing have completed.

Native macOS/Linux updates retain interrupted transfers and can use the verified official npm platform artifact when GitHub downloads fail. For recovery and a model generation check (aria health --model --tools --json), see updates and model diagnostics.

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 -C ~/Projects/my-app -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.

Google Cloud models can use Aria's local file and command tools: inference stays in the cloud while edits and tests run on your computer. Use --read-dir DIR for additional file-reading locations and --add-dir DIR for additional writable directories. Command-line directory grants last for this invocation only. See local projects and file access for permissions and Google authentication.

In a script or CI job, --json prints one JSON result and --format jsonl prints one JSON event per line as the turn runs (turn.started, tool.started, tool.completed, turn.completed). Only JSON goes to stdout, and a failed turn exits 1. With no one there to approve, pass --allow-tools edit_file,run_command for the tools the job may use.

aria-code -p "Fix the failing tests and run them" --format jsonl --allow-tools edit_file,run_command > events.jsonl

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 GOOGLE_CLOUD_PROJECT and either a gcloud auth login (Aria uses Vertex AI's OpenAI-compatible endpoint with that login's token) or Application Default Credentials with aria-code[google]. GOOGLE_CLOUD_LOCATION defaults to global. Any model your project can use works without an API key: /model google/gemini-3.8-flash, the Gemini 3 previews (served only from global), or Gemma and other Model Garden managed models by their id (/model google/<id>), which go through Vertex's OpenAI-compatible endpoint.
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
Opt-in Rust CLI prototype and migration stages Rust CLI migration
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.

Shared financial tools can also run independently through the Financial Service MCP integration, with a reusable Finance workflow in Aria Plugins. Legacy financial commands remain available.

Metadata

Release files for aria-code 0.168.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aria-code 0.168.0
File Size Uploaded Provenance Actions
aria_code-0.168.0.tar.gz 2.6 MB Without provenance Details for aria_code-0.168.0.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for aria-code 0.168.0
File Actions
aria_code-0.168.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for aria_code-0.168.0-py3-none-win_amd64.whl
aria_code-0.168.0-py3-none-manylinux_2_17_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details for aria_code-0.168.0-py3-none-manylinux_2_17_x86_64.whl
aria_code-0.168.0-py3-none-manylinux_2_17_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details for aria_code-0.168.0-py3-none-manylinux_2_17_aarch64.whl
aria_code-0.168.0-py3-none-macosx_13_0_x86_64.whl Python 3 none macOS 13.0+ x86-64 Details for aria_code-0.168.0-py3-none-macosx_13_0_x86_64.whl
aria_code-0.168.0-py3-none-macosx_13_0_arm64.whl Python 3 none macOS 13.0+ ARM64 Details for aria_code-0.168.0-py3-none-macosx_13_0_arm64.whl
aria_code-0.168.0-py3-none-any.whl Python 3 none any Details for aria_code-0.168.0-py3-none-any.whl

Total release size: 87.2 MB

Release files / aria_code-0.168.0.tar.gz

Download URL aria_code-0.168.0.tar.gz
Size 2.6 MB
Tags Source
SHA-256 checksum
How to use checksums
f8c05c073f15e8c53d1917025860303dfbf6698bced380774dcc1069debfc093
BLAKE2b-256 checksum
How to use checksums
694dbfa7e44fca3ec70b815513e11a214b82477e60838e9d07190dc72bea111c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","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.168.0-py3-none-win_amd64.whl

Download URL aria_code-0.168.0-py3-none-win_amd64.whl
Size 16.8 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
6b63daa3c0fd1fbb8fbb26efea2c8254bc191bce8ae917a672e9d819c8fec260
BLAKE2b-256 checksum
How to use checksums
4f138d197c0236e07081cf77665624f0b3863a10c7d8af2f3463a50b9558db3d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","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.168.0-py3-none-manylinux_2_17_x86_64.whl

Download URL aria_code-0.168.0-py3-none-manylinux_2_17_x86_64.whl
Size 16.9 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
868105c375bace90b02ba6dfc1b8a07ad2b308030cff421cc47a276fe0f3e38b
BLAKE2b-256 checksum
How to use checksums
17094be8a4d3d6519cc933720484922513aa04376dc863adec937efc961cfa3b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","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.168.0-py3-none-manylinux_2_17_aarch64.whl

Download URL aria_code-0.168.0-py3-none-manylinux_2_17_aarch64.whl
Size 15.7 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
fd2597b0599cb6cc0d7f428e062a626f0cff6ad568e92a2fc5635b5a0628a168
BLAKE2b-256 checksum
How to use checksums
07c3cc4515d1c5fcb577f840b846e4c63055e219a4b36c313f21b0bdb50c4b8f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","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.168.0-py3-none-macosx_13_0_x86_64.whl

Download URL aria_code-0.168.0-py3-none-macosx_13_0_x86_64.whl
Size 16.9 MB
Tags Python 3 macOS 13.0+ x86-64
SHA-256 checksum
How to use checksums
15297f67a5854ef15fc86c683646637bd3b1ad0ad0ab8e49fc71cce7c2404f26
BLAKE2b-256 checksum
How to use checksums
d28b0c279d0fe38925ca9367bbaa0452c8d634b39aee880c5433dc2d8afcbbbb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","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.168.0-py3-none-macosx_13_0_arm64.whl

Download URL aria_code-0.168.0-py3-none-macosx_13_0_arm64.whl
Size 15.9 MB
Tags Python 3 macOS 13.0+ ARM64
SHA-256 checksum
How to use checksums
52350df46055fff808f9654d3a35c66135a12a7dcb1d6625c3d4bc699cc937e6
BLAKE2b-256 checksum
How to use checksums
b7323d7803433fc7c102f36c78a19bad311320f89cfc6abb1574223298b5f160
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","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.168.0-py3-none-any.whl

Download URL aria_code-0.168.0-py3-none-any.whl
Size 2.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
7cf828a617f33153748d4d4767776af03b00ef31c0cd528be4d29483856b5390
BLAKE2b-256 checksum
How to use checksums
00cac8923c6f384a71dd9ce56ada76701bf69324a14029ae6077641c240f2c14
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","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}

Security for aria-code 0.168.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.168.0 This release

7 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page