AionisPro

AionisPro is the full Aionis repository: the self-hosted runtime, SDKs, docs site, ops surfaces, and shared runtime split that sit above the public Lite path.

Aionis is built around three product goals:

1. Continuity: agents keep context, handoff state, and resumable work across sessions.
2. Memory evolution: the system learns reusable workflows and trusted patterns instead of rediscovering them.
3. Controlled forgetting: the runtime can compress, suppress, and retain the right artifacts instead of accumulating noise.

Repository split

1. Cognary/Aionis Public Lite repository for the local single-user path.
2. Cognary/AionisPro Full repository for Server, SDKs, docs, playground, ops, replay, automation, and shared runtime packaging.

Start here

Docs now follow a simple structure:

1. Docs home
2. Start
3. Product
4. Reference
5. API Reference

Recommended public agent entrypoints:

1. POST /v1/memory/agent/inspect
2. POST /v1/memory/agent/task-pack
3. POST /v1/memory/agent/cycle-pack

Install and run

Option 1: use the public Lite repository

Fastest path for a local single-user setup:

git clone https://github.com/Cognary/Aionis.git
cd Aionis
cp .env.example .env
npm install
npm run -s env:bundle:local-safe
npm run build
npm run start:lite

Health check:

curl -fsS http://localhost:3001/health | jq

Option 2: start Lite with the official CLI

npx @aionis/sdk@0.2.21 dev
npx @aionis/sdk@0.2.21 health --base-url http://127.0.0.1:3321

Option 3: run the self-hosted Server path from AionisPro

git clone https://github.com/Cognary/AionisPro.git
cd AionisPro
cp .env.example .env
npm run -s env:bundle:local-safe
make stack-up
curl -fsS http://localhost:3001/health | jq

SDKs

TypeScript

npm install @aionis/sdk@0.2.21

import { AionisClient } from "@aionis/sdk";

const client = new AionisClient({
  base_url: "http://127.0.0.1:3321",
});

const inspect = await client.agentInspect({
  query_text: "what should this agent work on next?",
  scope: "default",
});
const taskPack = await client.agentTaskPack({
  query_text: "prepare the next coding task contract",
  scope: "default",
});
const cyclePack = await client.agentCyclePack({
  query_text: "continue the current coding loop",
  scope: "default",
});

console.log(inspect.request_id, taskPack.request_id, cyclePack.request_id);

Python

pip install aionis-sdk==0.2.21

from aionis_sdk import AionisClient

client = AionisClient(base_url="http://127.0.0.1:3321")

inspect = client.agent_inspect({
    "query_text": "what should this agent work on next?",
    "scope": "default",
})
task_pack = client.agent_task_pack({
    "query_text": "prepare the next coding task contract",
    "scope": "default",
})
cycle_pack = client.agent_cycle_pack({
    "query_text": "continue the current coding loop",
    "scope": "default",
})

print(inspect.get("request_id"), task_pack.get("request_id"), cycle_pack.get("request_id"))

Opt-in policy governance auto-apply

If you want Aionis to automatically apply a recommended refresh, reactivate, or retire step before returning the final contract, pass:

• policy_governance_apply_mode: "auto_apply"

This is supported on:

• POST /v1/memory/agent/inspect
• POST /v1/memory/agent/task-pack
• POST /v1/memory/agent/cycle-pack
• POST /v1/memory/evolution/inspect
• POST /v1/memory/evolution/review-pack
• POST /v1/memory/planning/context
• POST /v1/memory/context/assemble

TypeScript example:

const taskPack = await client.agentTaskPack({
  query_text: "continue the export repair task",
  scope: "coding",
  session_id: "sess_123",
  candidates: ["edit", "test"],
  context: {
    task_kind: "repair_export",
    goal: "repair export failure in node tests",
  },
  policy_governance_apply_mode: "auto_apply",
});

console.log(taskPack.data.policy_governance_apply_result);
console.log(taskPack.data.agent_memory_task_pack.policy_contract);

When auto-apply runs successfully, the response exposes:

• policy_governance_apply_result
• refreshed policy_contract
• updated policy_governance_contract

What is in this repository

This repository includes:

1. Self-hosted runtime for memory, continuity, replay, automation, and control surfaces.
2. Official TypeScript and Python SDKs.
3. CLI, MCP, playground, ops app, and docs site.
4. Shared runtime packaging used by the Lite and full runtime split.

Current product-facing areas line up with the docs site:

1. Start
2. Product Concepts, Agent Surfaces, Continuity, Evolution, Runtime Ops, Integrations
3. Reference API reference, operations, configuration, security, FAQ, roadmap

Contributing

See:

1. CONTRIBUTING.md
2. CODE_OF_CONDUCT.md
3. SECURITY.md

License

Licensed under the Apache License 2.0. See LICENSE.