cmdbox

cmdbox is a command foundation for AI system development that lets you launch with minimal implementation. A single feature implementation can be exposed through CLI / REST API / MCP SV / Web UI / Edge UI / remote execution.

cmdbox operation image

Why cmdbox for AI System Developers

  • No repeated reimplementation
    • Implement a Feature command once, then use the same capability via CLI, Web UI, and REST API.
    • It is easy to promote a PoC CLI workflow into operational Web/API interfaces without rewriting business logic.
  • AI-ready components out of the box
    • Modes such as agent, llm, mcpsv, and a2asv let you manage agent execution, model operations, MCP exposure, and A2A integration on one platform.
    • You can separate tool execution, inference, knowledge retrieval, and external integration while keeping a consistent operational model.
  • Rich Web UI for daily operations
    • Beyond APIs and CLI, cmdbox provides operational screens for commandlets, agents, filer, limiter, audit, and user management.
    • Teams can run, monitor, and control workflows from a browser without building a separate admin console.
  • Designed for remote execution
    • Server-side commands can run through Redis, which fits node separation and scale-out architectures.
    • Heavy workloads can be offloaded to servers while keeping client components lightweight.
  • Fast, configuration-driven extensibility
    • features.yml defines command discovery, aliases, argument rules, and agent execution rules, separating implementation from operations policy.
    • You can adjust exposed commands and execution policies without code changes, which is useful for environment-specific control.
  • Built-in governance capabilities
    • You can combine audit logging, authentication/authorization (signin / oauth2 / saml / rule settings), and limiter controls.
    • It is easier to trace who executed which command under which conditions, enabling enterprise-grade operational control.

Problems It Solves Well

  • You need to launch internal AI tools quickly
    • Start with CLI features, then expose the same capabilities internally via Web and REST API.
  • Multiple teams/environments need one shared foundation
    • Run the same codebase across dev/stg/prod while switching execution policies through configuration.
  • You need safe integration between agents and existing systems
    • Combine MCP/A2A integration with authorization rules to control the scope of agent actions.
  • You need usage control and cost governance for AI operations
    • Use Limiter settings to enforce quotas/rate rules, prevent abuse, and keep usage and billing behavior predictable.
    • Define reusable plans and billing policies (period-based or metered) to align access control with commercial and internal chargeback models.

What You Can Build

  • Custom command development
    • Support complex option definitions, client/server execution, and Web execution.
    • Organize functionality by mode / cmd and standardize execution through a shared option model.
  • LLM integration
    • Chat, embedding, and configuration save/load/list workflows.
    • Manage model configurations and treat inference calls as operational commands.
  • Agent integration
    • Save/load agent settings, integrate MCP servers, and connect A2A servers.
    • Expand agent capabilities in phases while keeping clear boundaries on exposed tools.
  • Web UI operations
    • Use built-in screens for commandlets, agents, filer, limiter, audit, and user management.
    • Manage day-to-day operations from the browser while keeping the same backend command model.
  • Operational controls
    • Audit logs, authentication, command execution policy, and REST API controls.
    • Publish safely with permissions segmented by organization or user group and full traceability.
    • Configure plan and billing operations to support subscription-style access windows and metered charging models.

Typical Use Cases

  • Internal knowledge search combining document processing + LLM
  • Converting routine operations into commands and running them from Web UI with no-code interaction
  • Letting agents call internal tools safely within controlled boundaries
  • Running operational administration (filer, limiter, audit, and user control) from the built-in Web UI

Installation

pip install cmdbox[app]
cmdbox -v

Docker Environment Setup

  • Redis
cmdbox -m cmdbox -c redis_install
cmdbox -m cmdbox -c up -C redis
  • PostgreSQL (used by some commands)
cmdbox -m cmdbox -c pgsql_install
cmdbox -m cmdbox -c up -C pgsql
  • Full cmdbox suite
cmdbox -m cmdbox -c server_install
cmdbox -m cmdbox -c up -C cmdbox

Quick Start

cmdbox -m server -c start
cmdbox -m web -c start --signin_file .cmdbox/user_list.yml
cmdbox -m mcpsv -c start --signin_file .cmdbox/user_list.yml
cmdbox -m a2asv -c start --signin_file .cmdbox/user_list.yml

Tutorial

The tutorial content has moved to the following documentation:

License

This project is licensed under the MIT License, see the LICENSE file for details

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.8.4.6)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for hamacom2004jp from gravatar.com hamacom2004jp

Credits

PyPI data
Data sourced directly from PyPI's database.

Author: hamacom2004jp

License

MIT License (MIT)

Requires

Python >=3.10

Provides Extra

agent-mcp agent-adk agent-mem rag omni saml dev app

Tags

audit a2a agent cli cmdbox excel fastapi mcp redis restapi web

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cmdbox-0.8.3.6.tar.gz (2.3 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cmdbox-0.8.3.6-py3-none-any.whl (2.9 MB view details)

Uploaded Python 3

File details

Details for the file cmdbox-0.8.3.6.tar.gz.

File metadata

  • Download URL: cmdbox-0.8.3.6.tar.gz
  • Upload date:
  • Size: 2.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.11.8

File hashes

Hashes for cmdbox-0.8.3.6.tar.gz
Algorithm Hash digest
SHA256 c6f2ba0a85df8453446910abfccd94d85323789b96df128fe7b0eb9a49468291
MD5 ac5ecb892c605e73da5f35600c4f3f1c
BLAKE2b-256 67b1ebad2c119806ed23f53dc1c99bae24a33f622e235ea75057154e958ca2ac

See more details on using hashes here.

File details

Details for the file cmdbox-0.8.3.6-py3-none-any.whl.

File metadata

  • Download URL: cmdbox-0.8.3.6-py3-none-any.whl
  • Upload date:
  • Size: 2.9 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.11.8

File hashes

Hashes for cmdbox-0.8.3.6-py3-none-any.whl
Algorithm Hash digest
SHA256 377d7e7de1ab0336d1ff67b0755ab3fcb3eeb8b6e5abefff674f111d23eb2bbd
MD5 be525fca2b96a4c36402c2653cf32da9
BLAKE2b-256 d26e5061bde1a57911ec2d47cff104c1ecaf15e4761cda160a02af379f9290ed

See more details on using hashes here.

Release history Release notifications | RSS feed

0.8.4.6

2 files

0.8.4.5

2 files

0.8.4.4

2 files

0.8.4.3

2 files

0.8.4.2

2 files

0.8.4.1

2 files

0.8.4

2 files

0.8.3.7

2 files

This release

0.8.3.6 This release

2 files

0.8.3.4

2 files

0.8.3.3

2 files

0.8.3.2

2 files

0.8.3.1

2 files

0.8.3

2 files

0.8.2.1

2 files

0.8.2

2 files

0.8.1.4

2 files

0.8.1.3

2 files

0.8.1.2

2 files

0.8.1.1

2 files

0.8.1

2 files

0.8.0.3

2 files

0.8.0.2

2 files

0.8.0.1

2 files

0.8.0

2 files

0.7.16.1

2 files

0.7.16

2 files

0.7.15.4

2 files

0.7.15.3

2 files

0.7.15.2

2 files

0.7.15.1

2 files

0.7.15

2 files

0.7.14.1

2 files

0.7.14

2 files

0.7.13.2

2 files

0.7.13.1

2 files

0.7.13

2 files

0.7.12.1

2 files

0.7.12

2 files

0.7.11.3

2 files

0.7.11.2

2 files

0.7.11

2 files

0.7.10

2 files

0.7.9.1

2 files

0.7.9

2 files

0.7.8.5

2 files

0.7.8.4

2 files

0.7.8.3

2 files

0.7.8.2

2 files

0.7.8.1

2 files

0.7.8

2 files

0.7.7.2

2 files

0.7.7.1

2 files

0.7.7

2 files

0.7.6.4

2 files

0.7.6.3

2 files

0.7.6.2

2 files

0.7.6.1

2 files

0.7.6

2 files

0.7.5.4

2 files

0.7.5.3

2 files

0.7.5.2

2 files

0.7.5.1

2 files

0.7.5

2 files

0.7.4

2 files

0.7.3.2

2 files

0.7.3.1

2 files

0.7.3

2 files

0.7.2.5

2 files

0.7.2

2 files

0.7.1

2 files

0.7.0.4

2 files

0.7.0

2 files

0.6.6

2 files

0.6.5

2 files

0.6.4.2

2 files

0.6.4

2 files

0.6.3.2

2 files

0.6.3.1

2 files

0.6.3

2 files

0.6.2.4

2 files

0.6.2.3

2 files

0.6.2.2

2 files

0.6.2

2 files

0.6.1.1

2 files

0.6.1

2 files

0.6.0.4

2 files

0.6.0

2 files

0.5.4

2 files

0.5.3.1

2 files

0.5.3

2 files

0.5.2

2 files

0.5.1.2

2 files

0.5.1.1

2 files

0.5.1

2 files

0.5.0.8

2 files

0.5.0.7

2 files

0.5.0.6

2 files

0.5.0.5

2 files

0.5.0.4

2 files

0.5.0.3

2 files

0.5.0.2

2 files

0.5.0.1

2 files

0.5.0

2 files

0.4.5.1

2 files

0.4.5

2 files

0.4.4

2 files

0.4.3

2 files

0.4.2

2 files

0.4.1

2 files

0.4.0

2 files

0.3.0

2 files

0.2.9.2

2 files

0.2.9.1

2 files

0.2.9

2 files

0.2.8

2 files

0.2.7.3

2 files

0.2.7.2

2 files

0.2.7.1

2 files

0.2.7

2 files

0.2.6

2 files

0.2.5.3

2 files

0.2.5.2

2 files

0.2.5.1

2 files

0.2.5

2 files

0.2.4.5

2 files

0.2.4

2 files

0.2.3.2

2 files

0.2.3

2 files

0.2.2.9

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.2.6

2 files

0.1.2.5

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page