Installation

From PyPI

pip install apowerb

The package installs the apowerb CLI (a Typer application) alongside the library.

apowerb requires Python 3.12 or later. 3.11 is rejected: the code nests identical quotes inside f-strings (PEP 701), which 3.11 cannot parse.

Optional extras

Extra	Adds
`s3`	`s3fs`, `fsspec`, `aiobotocore` — S3 storage and S3 indexing

pip install "apowerb[s3]"

From source

git clone https://github.com/apowerb/apowerb.git
cd apowerb

pip install uv
uv venv
source .venv/bin/activate      # Windows: .venv\Scripts\activate

uv sync
uv pip install .
cp .env.example .env

Run the server

CLI
Uvicorn

apowerb serve --host 0.0.0.0 --port 8000

uv run uvicorn apowerb.main:app --reload

The server listens on http://127.0.0.1:8000/ by default, with interactive documentation at /docs.

CLI commands

apowerb serve --host 0.0.0.0 --port 8000

apowerb agents list
apowerb agents create
apowerb agents delete <agent_id>

apowerb tools list

apowerb runs list

Configuration

Every environment variable, required and optional.

Architecture

What happens on startup, and where the code lives.

Quickstart

Configuration

⌘I

Get started

Concepts

Guides

Self-hosting

Ecosystem

Contributing

From PyPI

Optional extras

From source

Run the server

CLI commands

Next

Configuration

Architecture

​From PyPI

​Optional extras

​From source

​Run the server

​CLI commands

​Next

Configuration

Architecture

From PyPI

Optional extras

From source

Run the server

CLI commands

Next