Skip to content

Arcana OS

The OS that gives your agents a soul.

Arcana OS is a multi-agent system where each AI agent is assigned a tarot card archetype that defines its personality, behaviour, and defaults. The card is not cosmetic, it generates the agent's system prompt, sets its temperature, and tone. Blend a primary card with modifiers to tune the mix.

The project ships as two packages: a Python library you build agents with, and a CLI that wraps it for everyday use.

uv tool install arcana-os

arcana init
arcana connect model -p ollama -m hermes-3 -n local
arcana agent create --name researcher --card hermit --model local
arcana run "what are the tradeoffs between RAG and fine-tuning?" --agent researcher --stream

The two packages

  • arcana-core — the Python library

    The real product. Card-configured agents that run locally through a model gateway. See the API reference.

  • arcana-cli — the command line

    A thin Typer wrapper: init, status, connect, agent, run, cards. See the CLI reference.

Where to go next