Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 43 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,11 @@ into the terminal, with guided ATS setup.
<!-- SOURCE-0.3-WORKFLOWS:START -->

> **Requires 0.3.2 or newer.** Check what you have with `aether --version`.
>
> The live npm badge below resolves the currently published `latest`. Until a
> verified `v0.4.0` tag and registry publication exist, the account-agent and
> ATS sections below describe the 0.4.0 source candidate on `main`; source text
> alone is not publication evidence.

## Quickstart

Expand All @@ -53,6 +58,31 @@ same work. See [`packages/pypi-cli`](packages/pypi-cli/README.md).

ATS is the trading adapter for account agents.

### What works now — and what does not

Aether Agent 0.4.0 has a real, account-bound ATS setup and observation path. It
can create the managed-agent draft, verify local memory, install and compile the
reviewed Nano starter strategies, save data-provider configuration, and open a
bounded browser observer. Those capabilities are useful today, but they are not
broker execution.

| Stage | 0.4.0 status | Release boundary |
|---|---|---|
| Account agent, consent and local ownership | **Available in the source candidate** | Identity-bound setup; consent never grants trading authority. |
| Memory, strategy scan/compile and data configuration | **Available in the source candidate** | Preparation and diagnostics only; no order can result. |
| Browser observation | **Available in the source candidate** | Read-only, freshness-checked images; no model-controlled browser action. |
| ATS runtime and market-data session | **Next implementation gate** | Must prove lifecycle, health, freshness, cancellation and cleanup before paper trading. |
| Paper-order execution and reconciliation | **Not shipped** | Requires typed intents, limits, idempotency, venue receipts and uncertain-outcome recovery. |
| Supervised live orders | **Not shipped** | Requires separate, scoped user authority, broker connectivity, preflight limits, confirmation and a kill switch. |
| Autonomous live trading | **Not shipped** | No setup choice, mode preference, strategy, chat message or policy receipt enables it. |

Execution work is deliberately sequential: establish the runtime and data-plane
contracts first, then paper execution and reconciliation, then supervised live
execution. Autonomous live authority is a later, separately qualified product
gate—not a side effect of installing 0.4.0. The exact candidate evidence and
remaining qualification are tracked in the
[operator packet](docs/releases/OPERATOR-PACKET-v0.4.0.md).

After signing in, use `aether agent list` to see the same managed agents as
Aether Online. `aether agent chat` opens the one-column picker; select an agent
to read and send messages in its existing Online conversation.
Expand Down Expand Up @@ -101,8 +131,10 @@ These commands require the matching Cloud terminal adapter. ATS setup also
requires its Python engine and a separately running Agent Browser runtime;
missing services are reported explicitly. This candidate prepares and observes
an ATS workspace. It does not yet provide model-controlled broker actions or
automatic live orders. See the [candidate packet](docs/releases/OPERATOR-PACKET-v0.4.0.md)
for the qualification still required before publication.
automatic live orders: it does not start an execution engine, connect a broker,
or submit or reconcile orders. See the
[candidate packet](docs/releases/OPERATOR-PACKET-v0.4.0.md) for the qualification
still required before publication.

## Pick where the model runs

Expand Down Expand Up @@ -143,7 +175,7 @@ you are signed in. The snapshot below is a dated reference, published so the
list is readable without signing in first.

<!-- MODEL-CATALOGUE:START -->
A dated, sanitized offline fallback snapshot is available as [HTML](docs/model-catalogue/index.html), [JSON](docs/model-catalogue/catalogue.json), and [Markdown](docs/generated/model-catalogue.md). It was generated at `2026-08-23T00:00:00.000Z` from Cloud public projection `model-catalogue-v1` with verified digest `sha256:80ba3ba1144d301e2cca407ceced74cb2b371f1da6e3982b87305ff12a3d4712`. Listed availability is not an account entitlement; use `aether models` while signed in.
A dated, sanitized offline fallback snapshot is available as [HTML](docs/model-catalogue/index.html), [JSON](docs/model-catalogue/catalogue.json), and [Markdown](docs/generated/model-catalogue.md). It was generated at `2026-09-22T01:47:56.169Z` from Cloud public projection `model-catalogue-v1` with verified digest `sha256:f5f516625932d8932bfca221aa5dbf3eb1d7b415eba8dabe298da24b984c64f7`. Listed availability is not an account entitlement; use `aether models` while signed in.
<!-- MODEL-CATALOGUE:END -->

Local Ollama is independent of all of it — you get whatever you have installed
Expand All @@ -168,6 +200,7 @@ at your configured endpoint.
|---|---|
| `aether auth login` | Sign in for hosted models. |
| `aether agent [task]` | Run the coding agent, or open its REPL. |
| `aether agent list\|create\|configure\|chat` | List, create and configure account agents, or open their shared Online DM conversation (0.4.0 source candidate). |
| `aether agent --local [task]` | Same, through your Ollama endpoint. |
| `aether models` | Show the hosted models your account can see. |
| `aether local doctor\|models\|use\|pull` | Diagnose and manage local Ollama. |
Expand Down Expand Up @@ -198,12 +231,14 @@ standalone and open source: on the local route it needs no Aether account at
all. Coding workspace sessions stay on their host; the managed-agent workflow
above shares account agents and their Online DM conversations.

### Coming next: live session viewing
### Remote viewing status in the 0.4.0 source candidate

Remote viewing — /rc — is the bridge between the terminal and the browser, and
it is being integrated now. The host lives in
[PR #108](https://github.com/AetherAI3/aether-agent/pull/108) and is **not part
of 0.3.x**, so nothing below is something you can run yet. What it will do:
Remote viewing — `aether rc` — is the observer-only bridge between a terminal
run and the browser. Its host foundation and local status/exposure controls are
on `main`; they remain outside the published 0.3.x line. A fully qualified live
Cloud viewer journey is still unproven, and the old draft
[PR #108](https://github.com/AetherAI3/aether-agent/pull/108) is not release
evidence for current `main`. The source-candidate contract is:

- Starting a session prints a link and a QR code.
- Your phone or browser **watches** the run. It never gets tool authority.
Expand Down
2 changes: 1 addition & 1 deletion RELEASE_NOTES.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
size and location, and scans a strategy folder. Local settings stay bound to
the selected agent and Cloud origin. A local memory receipt does not satisfy
Cloud's separate APR activation requirements.
- **Packaged ATS adapters.** The reviewed `aether-ats-skills` 0.1.0 source is
- **Packaged ATS adapters.** The reviewed `aether-ats-skills` 0.2.0 source is
bundled with the CLI, with exact `aether-browser` 0.2.2 and `aether-context`
0.3.1 dependencies. Installation hooks remain forbidden. The existing Python
launcher remains free of Python runtime dependencies.
Expand Down
85 changes: 45 additions & 40 deletions docs/generated/model-catalogue.md
Original file line number Diff line number Diff line change
@@ -1,68 +1,73 @@
<!-- GENERATED FILE: run `npm run docs:generate`; do not edit by hand. -->
<!-- catalogue-digest: sha256:c9fe0efd73b5c390b0274e15640da7cbfe036e759d121984699d6d2d39564de1 -->
<!-- catalogue-digest: sha256:62ee39eac95744da861e34e95eb1f41f4ffda6b86622614c68b01f036ecd8f48 -->
# Public model catalogue snapshot

Sanitized Cloud public model projection\. Listed availability describes publication status, not account entitlement\.

- Snapshot time: `2026-08-23T00:00:00.000Z`
- Snapshot time: `2026-09-22T01:47:56.169Z`
- Source: Cloud public projection `model-catalogue-v1`
- Source digest: `sha256:80ba3ba1144d301e2cca407ceced74cb2b371f1da6e3982b87305ff12a3d4712`
- Source digest: `sha256:f5f516625932d8932bfca221aa5dbf3eb1d7b415eba8dabe298da24b984c64f7`
- Availability: `listed-not-entitled`
- Offline fallback snapshot: yes
- Digest: `sha256:c9fe0efd73b5c390b0274e15640da7cbfe036e759d121984699d6d2d39564de1`
- Digest: `sha256:62ee39eac95744da861e34e95eb1f41f4ffda6b86622614c68b01f036ecd8f48`

| Model | ID | Provider | Modality | Tier | Availability |
|---|---|---|---|---|---|
| AETHER Kronus V2\.4 | `aether-kronus-v2.4` | aether | text | pro | unavailable |
| AETHER Kronus V2\.4 | `aether-kronus-v2.4` | aether | text | pro | available |
| AETHER Neo 5\.1T | `aether-neo-5.1t` | aether | text | solo | available |
| AETHER Vision | `aether-vision` | aether | multimodal | pro | unavailable |
| AETHER Vision | `aether-vision` | aether | multimodal | pro | available |
| DeepSeek V4 Flash | `dsv4_flash` | text | text | free | available |
| DeepSeek V4 Pro | `dsv4_pro` | text | text | pro | available |
| Gemini 3\.6 Flash | `gemini36_flash` | text | text | pro | unavailable |
| Claude Fable 5\.1 | `fable51` | text | text | pro | available |
| Gemini 3\.6 Flash | `gemini36_flash` | text | text | pro | available |
| Gemini 3\.8 Flash | `gemini38_flash` | text | text | pro | available |
| Gemma 4 26B MoE | `gemma4_26b_moe` | text | text | pro | unavailable |
| Gemma 4 31B | `gemma4_31b` | text | text | pro | unavailable |
| Gemma 4 31B | `gemma4_31b` | text | text | pro | available |
| Gemma 4 31B \(free\) | `gemma4_31b_free` | text | text | free | unavailable |
| GPT\-5\.4 mini | `gpt54_mini` | text | text | solo | available |
| GPT\-5\.5 | `gpt55` | text | text | pro | available |
| GPT\-5\.6 Luna | `gpt56_luna` | text | text | pro | available |
| GPT\-5\.6 Sol | `gpt56_sol` | text | text | pro | available |
| GPT\-5\.6 Terra | `gpt56_terra` | text | text | pro | available |
| GPT\-6 Astra | `gpt6_astra` | text | text | pro | available |
| Grok 4\.6 | `grok46` | text | text | pro | available |
| Claude Haiku 4\.5 | `haiku` | text | text | free | available |
| Kimi K2\.6 | `kimi_k26` | text | text | pro | unavailable |
| Kimi K2\.6 | `kimi_k26` | text | text | pro | available |
| Kimi K2\.6 Thinking | `kimi_k26_thinking` | text | text | pro | unavailable |
| Kimi K3 | `kimi_k3` | text | text | pro | unavailable |
| Kimi K3 | `kimi_k3` | text | text | pro | available |
| Claude Opus 4\.8 | `opus` | text | text | pro | available |
| Claude Opus 5 | `opus5` | text | text | pro | available |
| Qwen 3\.8 Max | `qwen38_max` | text | text | pro | available |
| Claude Sonnet 5 | `sonnet` | text | text | solo | available |
| FLUX\.2 Flex | `vision_flux2_flex` | image | image | solo | unavailable |
| FLUX\.2 Klein 4B | `vision_flux2_klein` | image | image | solo | unavailable |
| FLUX\.2 Max | `vision_flux2_max` | image | image | solo | unavailable |
| FLUX\.2 Pro | `vision_flux2_pro` | image | image | solo | unavailable |
| GPT Image 2 | `vision_gpt_image2` | image | image | solo | unavailable |
| GPT\-5 Image | `vision_gpt5_image` | image | image | solo | unavailable |
| GPT\-5 Image Mini | `vision_gpt5_image_mini` | image | image | solo | unavailable |
| Grok Imagine Video | `vision_grok_video` | video | video | pro | unavailable |
| Hailuo 2\.3 | `vision_hailuo23` | video | video | pro | unavailable |
| HappyHorse 1\.0 | `vision_happyhorse` | video | video | pro | unavailable |
| Kling 3\.0 Standard | `vision_kling` | video | video | pro | unavailable |
| Kling Video O1 | `vision_kling_o1` | video | video | pro | unavailable |
| Kling 3\.0 Pro | `vision_kling_pro` | video | video | pro | unavailable |
| Nano Banana | `vision_nano_banana` | image | image | solo | unavailable |
| Nano Banana 2 | `vision_nano_banana2` | image | image | solo | unavailable |
| Nano Banana Pro | `vision_nano_pro` | image | image | free | unavailable |
| Recraft V3 | `vision_recraft` | image | image | solo | unavailable |
| Recraft V4 | `vision_recraft_v4` | image | image | solo | unavailable |
| Riverflow V2 Fast | `vision_riverflow_fast` | image | image | solo | unavailable |
| Riverflow V2 Pro | `vision_riverflow_pro` | image | image | solo | unavailable |
| Seedance 2\.0 | `vision_seedance` | video | video | pro | unavailable |
| Seedance 2\.0 Fast | `vision_seedance_fast` | video | video | pro | unavailable |
| Seedance 1\.5 Pro | `vision_seedance15_pro` | video | video | pro | unavailable |
| Seedream 4\.5 | `vision_seedream45` | image | image | solo | unavailable |
| Sora 2 Pro | `vision_sora2_pro` | video | video | pro | unavailable |
| Veo 3\.1 | `vision_veo31` | video | video | pro | unavailable |
| Veo 3\.1 Fast | `vision_veo31_fast` | video | video | pro | unavailable |
| Veo 3\.1 Lite | `vision_veo31_lite` | video | video | pro | unavailable |
| Wan 2\.6 | `vision_wan26` | video | video | pro | unavailable |
| Wan 2\.7 | `vision_wan27` | video | video | pro | unavailable |
| FLUX\.2 Flex | `vision_flux2_flex` | image | image | solo | available |
| FLUX\.2 Klein 4B | `vision_flux2_klein` | image | image | solo | available |
| FLUX\.2 Max | `vision_flux2_max` | image | image | solo | available |
| FLUX\.2 Pro | `vision_flux2_pro` | image | image | solo | available |
| GPT Image 2 | `vision_gpt_image2` | image | image | solo | available |
| GPT\-5 Image | `vision_gpt5_image` | image | image | solo | available |
| GPT\-5 Image Mini | `vision_gpt5_image_mini` | image | image | solo | available |
| Grok Imagine Video | `vision_grok_video` | video | video | pro | available |
| Hailuo 2\.3 | `vision_hailuo23` | video | video | pro | available |
| HappyHorse 1\.0 | `vision_happyhorse` | video | video | pro | available |
| Kling 3\.0 Standard | `vision_kling` | video | video | pro | available |
| Kling Video O1 | `vision_kling_o1` | video | video | pro | available |
| Kling 3\.0 Pro | `vision_kling_pro` | video | video | pro | available |
| Nano Banana | `vision_nano_banana` | image | image | free | available |
| Nano Banana 2 | `vision_nano_banana2` | image | image | solo | available |
| Nano Banana Pro | `vision_nano_pro` | image | image | solo | available |
| Recraft V3 | `vision_recraft` | image | image | solo | available |
| Recraft V4 | `vision_recraft_v4` | image | image | solo | available |
| Riverflow V2 Fast | `vision_riverflow_fast` | image | image | solo | available |
| Riverflow V2 Pro | `vision_riverflow_pro` | image | image | solo | available |
| Seedance 2\.0 | `vision_seedance` | video | video | pro | available |
| Seedance 2\.0 Fast | `vision_seedance_fast` | video | video | pro | available |
| Seedance 1\.5 Pro | `vision_seedance15_pro` | video | video | pro | available |
| Seedream 4\.5 | `vision_seedream45` | image | image | solo | available |
| Sora 2 Pro | `vision_sora2_pro` | video | video | pro | available |
| Veo 3\.1 | `vision_veo31` | video | video | pro | available |
| Veo 3\.1 Fast | `vision_veo31_fast` | video | video | pro | available |
| Veo 3\.1 Lite | `vision_veo31_lite` | video | video | pro | available |
| Wan 2\.6 | `vision_wan26` | video | video | pro | available |
| Wan 2\.7 | `vision_wan27` | video | video | pro | available |

Runtime availability is account-scoped. Use `aether models` while signed in for the authoritative live result. This snapshot contains no prices, spend caps, internal routes, or credentials.
Loading
Loading