CLI Reference

Create

abi-core create project

abi-core create project --name <name> [OPTIONS]

Option

Description

--name, -n

Project name (required)

--description, -d

Project description

--domain

Domain (finance, healthcare, general)

--with-semantic-layer

Include Weaviate + MCP server

--with-guardian

Include Guardian + OPA

--model-serving

centralized or distributed

 
abi-core create project my-app \
  --with-semantic-layer \
  --with-guardian \
  --model-serving centralized

abi-core create swarm

Warning

Alpha. The ABI Swarm (Orchestrator + Planner + Builder + ephemeral agents) is under active development. APIs, generated structure, and behavior may change between releases. Not recommended for production yet.

Creates a full project + Orchestrator + Planner + Builder in one command.

abi-core create swarm --name my-swarm

Add

abi-core add agent

abi-core add agent --name <name> [OPTIONS]

Option

Description

--name, -n

Agent name (required)

--description, -d

What the agent does

--model

LLM model (default: qwen2.5:3b)

--with-web-interface

Add HTTP/SSE endpoints

 
abi-core add agent analyst \
  --description "Analyzes financial data" \
  --model qwen2.5:3b \
  --with-web-interface

Creates: agents/<name>/ with app.py, steps.py, tasks.py, tools.py, prompts.py, config/, Dockerfile, agent_cards/.

abi-core add service

abi-core add service <type>

Types: semantic-layer, guardian-native

abi-core add chainlit

abi-core add chainlit [--url http://<project>-<agent>:<port>] [--title "My Chat"] [--dir ui]

Adds a Chainlit chat UI as a Docker service, wired into the project’s compose.yaml and network. It’s a thin SSE client over an agent’s /stream endpoint that opens a framework-managed session (so multi-turn stays coherent) and streams status/result updates.

If --url is omitted, the target agent is auto-detected from .abi/runtime.yaml (the agent with a web interface, preferring the orchestrator). The UI gets a dynamic host port; started by abi-core run alongside the rest of the stack.

Option

Description

--url

Target agent /stream URL as a Docker service name (auto-detected if omitted)

--title

UI title (default <project> Chat)

--dir

Output directory (default ui)

 
abi-core add chainlit     # auto-detects the web agent, adds the service
abi-core run              # builds + starts everything, including the UI

The command prints the host URL (e.g. http://localhost:8500). Override the target at runtime with the ABI_AGENT_URL environment variable on the chatui service.

Run

abi-core run

abi-core run [OPTIONS]

Option

Description

--logs

Show container output

--build

Rebuild containers first

Equivalent to docker compose up -d.

Other commands

Command

Description

abi-core provision-models

Pull LLM + embedding models into Ollama

abi-core status

Show running services and ports

abi-core info

Show project configuration

abi-core remove agent <name>

Remove an agent

abi-core remove service <name>

Remove a service

Typical workflow

abi-core create project my-app --with-semantic-layer
cd my-app
abi-core add agent my-agent --description "..." --with-web-interface
docker compose up ollama -d
abi-core provision-models
docker compose up --build -d