bos-ai 1.12.0

An agent out of the box. A framework for your own agent-native applications.

 ███████████     ███████     █████████
░░███░░░░░███  ███░░░░░███  ███░░░░░███
 ░███    ░███ ███     ░░███░███    ░░░
 ░██████████ ░███      ░███░░█████████
 ░███░░░░░███░███      ░███ ░░░░░░░░███
 ░███    ░███░░███     ███  ███    ░███
 ███████████  ░░░███████░  ░░█████████
░░░░░░░░░░░     ░░░░░░░     ░░░░░░░░░

An agent out of the box. A framework for your own agent-native applications.

Quick Start

pip install bos-ai
OPENAI_API_KEY=<api-key> boscli ask "how are you" --model openai/gpt-4o

Using a different provider? See LiteLLM's provider docs for the right BOS_MODEL prefix and required environment variables. For example, using deepseek model

DEEPSEEK_API_KEY=<api-key> boscli ask "how are you" --model odeepseek/deepseek-v4-pro

Alternatively, it could use uvx to start:

OPENAI_API_KEY=<api-key> uvx boscli ask "how are you" --model openai/gpt-4o

Install uv to get the uvx.

Project Setup

mkdir my-agent && cd my-agent
boscli init          # guided setup: purpose, topology, model — writes a runnable baseline
boscli gateway start # start the agent runtime
boscli tui           # connect the terminal UI

Docs

See the documentation site for tutorials, architecture, extension points, and the configuration reference.

Building on BOS with an AI agent? llm-full.md is a single dense, code-grounded reference covering every mechanism — configuration, extension points, plugins, channels, skills, the CLI, and the runtime — in one file. boscli init drops a copy into every scaffolded project.

License

See LICENSE.