BOT: Standardized Agent Framework

bot is a local-first agent framework for observable execution, composable tool use, and multi-agent orchestration.

Safety Model

• Network: Core demos do not initiate outbound network requests by default.
• Execution: This release provides policy-guarded local execution, not OS-level sandbox isolation.
• File System: Local memory is stored in

  ./.bot_memory/

  by default, configurable via

  BOT_MEMORY_DIR

  .
• Viewer: Optional local monitor binds to

  127.0.0.1

  only when explicitly started.
• Credentials: No external API keys required for core demos.

Included Capabilities

• Single-agent reasoning core
• Botfile static declaration
• TUI thought visualization
• Crypto identity and signing
• Multi-agent coordination
• Local Web thought-tree viewer
• Unified local run entrypoint
• Capability-aware tool registration
• Policy-guarded execution layer

Quick Start

PYTHONPATH=. python3 examples/run_bot.py --mode multi --prompt "Design a safe local-first agent workflow"

Custom Roles

PYTHONPATH=. python3 examples/run_bot.py --mode multi --roles "planner_bot,critic_bot,executor_bot,auditor_bot"

Single-Agent Mode

PYTHONPATH=. python3 examples/run_bot.py --mode single --prompt "Summarize this task safely"

Then open:

• http://127.0.0.1:8765