Plutus工作流

Install dev dependencies

pip install -e ".[dev]"

Installation

Linux & macOS:

curl -fsSL https://useplutus.ai/install.sh | bash

Windows (PowerShell):

iwr -useb https://useplutus.ai/install.ps1 | iex

That's it — the installer handles everything (dependencies, setup wizard, and first launch).

<details> <summary>Manual installation</summary>

```bash

Install with pip

pip install -e .

Run setup wizard

plutus setup ```

</details>

Setup wizard

plutus setup

Quick Start

Example: Agent creates a CSV processor tool

tool_creator( operation="create", tool_name="csv_processor", description="Process and transform CSV files", code=""" import csv from pathlib import Path

def main(args): path = args.get('path', '') operation = args.get('operation', 'read') if operation == 'read': with open(path) as f: reader = csv.DictReader(f) rows = list(reader) return {'success': True, 'result': {'rows': rows, 'count': len(rows)}} elif operation == 'sort': column = args.get('column', '') with open(path) as f: reader = csv.DictReader(f) rows = sorted(list(reader), key=lambda r: r.get(column, '')) return {'success': True, 'result': {'rows': rows, 'count': len(rows)}} return {'success': False, 'error': f'Unknown operation: {operation}'} """ ) ```

Created tools are: - Validated — syntax-checked before saving - Persisted — saved to ~/.plutus/custom_tools/ across sessions - Hot-loaded — immediately available in the tool registry - Isolated — executed in subprocess workers

Configuration

Config File: `~/.plutus/config.json`

{
  "model": {
    "provider": "anthropic",
    "model": "claude-sonnet-4-6",
    "temperature": 0.7,
    "max_tokens": 4096
  },
  "guardrails": {
    "tier": "operator",
    "audit_enabled": true
  },
  "agent": {
    "max_tool_rounds": 25
  },
  "planner": {
    "enabled": true,
    "auto_plan": true
  },
  "gateway": {
    "host": "127.0.0.1",
    "port": 7777
  }
}

Environment variable

export ANTHROPIC_API_KEY=sk-ant-...

Or via the web UI settings page

```

Multiple Interfaces

• Terminal REPL (plutus chat) — Rich interactive chat with slash commands
• Single prompt (plutus run "...") — Execute one task and exit
• Web UI (plutus start) — Full web interface with WebSocket streaming

API Keys

Keys are stored securely in ~/.plutus/.secrets.json (chmod 600) and never exposed via the API. Set them via:

```bash

CLI Reference

plutus                  # Show help
plutus start            # Launch web UI + API server
plutus chat             # Interactive terminal chat
plutus run "prompt"     # Run a single prompt
plutus setup            # Setup wizard
plutus status           # Show configuration
plutus tools            # List available tools
plutus set-tier <tier>  # Change guardrail tier
plutus audit            # Show audit log
plutus config-show      # Display full config as JSON