10xScale Agentflow CLI

10xScale Agentflow CLI turns an Agentflow CompiledGraph into a production-grade FastAPI service, plus a Typer-based command line to scaffold, run, build, test, and evaluate it. You write a graph, point agentflow.json at it, and agentflow api serves it over REST + WebSocket with authentication, rate limiting, media handling, checkpointer/thread management, and a memory store API.

### 📦 Part of the 10xScale Agentflow library This package (10xscale-agentflow-cli) is the API server + CLI layer of the larger 10xScale Agentflow framework. The core orchestration engine — StateGraph, Agent, ToolNode, state, persistence, memory, and tools — lives in the separate 10xscale-agentflow package. This CLI builds on top of it to expose your agent graphs as a deployable service. - Core framework: 10xscale-agentflow · source - This package (API + CLI): 10xscale-agentflow-cli - TypeScript client: @10xscale/agentflow-client - Docs: agentflow.10xscale.ai

---

✨ Key Features

🖥️ Professional CLI - Scaffold, run, build, test, and evaluate agents from one command line
⚡ FastAPI Backend - Your compiled graph auto-served over REST + WebSocket, high-performance and async
🔌 Config-Driven - One agentflow.json wires agent, auth, checkpointer, store, Redis, and rate limits
🔐 Authentication - Built-in JWT auth, custom BaseAuth backends, and RBAC authorization
🚦 Rate Limiting - Sliding-window limits with memory, Redis, or custom backends
🆔 Distributed IDs - Snowflake ID generation for multi-node deployments

🧵 Thread Management - Conversation thread naming, listing, state, and message APIs
🖼️ Multimodal & Media - File upload/download endpoints and media handling for multimodal agents
🎙️ Realtime Audio Bridge - WebSocket endpoint for live audio-to-audio agents (Gemini Live)
🐳 Docker & Kubernetes Ready - Generate production Dockerfiles and compose files with one command
🛡️ Production Hardening - Error/log sanitization, request size limits, security headers, startup validation
💉 Dependency Injection - InjectQ for clean, testable dependency wiring

---

Installation

Basic installation:

pip install 10xscale-agentflow-cli

Optional extras — install only what you configure:

pip install "10xscale-agentflow-cli[redis]"   # Redis rate-limit / cache backend
pip install "10xscale-agentflow-cli[jwt]"     # JWT authentication
pip install "10xscale-agentflow-cli[media]"   # Document text extraction (multimodal)
pip install "10xscale-agentflow-cli[otel]"    # OpenTelemetry tracing
pip install "10xscale-agentflow-cli[snowflakekit]"  # Snowflake ID generation

Requires Python ≥ 3.12. Depends on the core 10xscale-agentflow framework.

---

🚀 Quick Start

# 1. Scaffold a project (interactive: dev vs production, auth, rate limiting)
agentflow init

# 2. Start the dev API server (127.0.0.1:8000)
agentflow api

# 3. Or start the server and open the hosted playground
agentflow play

# 4. Generate production Docker files
agentflow build --docker-compose

---

10xscale-agentflow-cli

安装

README.md