Aria Code

An open-source AI agent for logistics and finance work.
Numbers you can check, client data kept apart, actions a person approves.

简体中文 · English

_{Recorded from a real Aria Code session on the sample 3PL data in evals/fixtures. No model is called, so every number on screen comes from the tools; pauses are shortened. Still screenshot · Recorder · Renderer.}

What Aria Code does

A general-purpose assistant aims for an answer that reads well. In logistics and finance the number gets acted on — one purchase order left out of a reorder quantity and the stock is bought twice. Aria Code is built around three things that follow from that.

Numbers you can check. Reorder points, safety stock and carrier rankings come from stated formulas, 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 Feishu, each shipper's group gets a daily digest of reorders, dead stock and freight anomalies. /补货 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.

Underneath is a terminal coding agent: it inspects project files, applies edits, runs commands and tests, and explains the changes (recording), with a local Ollama model or a supported cloud provider. A fresh install has no live business data; the logistics tools read your exports (CSV or JSON), 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.

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

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

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.