自动化AI工作流

Prerequisites

• Python 3.11 or higher
• NVIDIA API Key (for model execution)

Installation

PyPI Install

pip install autobot-swarm

Development Install

git clone https://github.com/DanielDeshmukh/autobots.git
cd autobots
python -m pip install -e . --no-build-isolation

---

API Key Setup

```powershell

[PASS] Package: autobot-swarm installed

Quick Start

```powershell

Cross-Platform Usage

Configuration

Option 1: .env file

echo NVIDIA_API_KEY=your_key_here > .env

Option 2: Environment variable

$env:NVIDIA_API_KEY = "your_key_here" ```

Configuration File

Create .autobots.toml or autobots.toml in your project root or $HOME:

```toml [autobots] model_selection_profile = "balanced" # balanced, speed, or quality parallel_planning = false disable_live_catalog = false safety_branch = "autobots-safety" default_mode = "supervised" # supervised, milestone, autonomous milestone_threshold = 3 max_verification_attempts = 3 temperature = 0.2 max_tokens = 4096

Optional: custom model registry

Optional: extra custom clusters

Permission Settings

Create ~/.autobots/settings.json (global) or .autobots/settings.json (project):

{
  "permissions": {
    "default": "ask",
    "rules": [
      {"tool_pattern": "Read", "permission": "allow"},
      {"tool_pattern": "Glob", "permission": "allow"},
      {"tool_pattern": "Grep", "permission": "allow"},
      {"tool_pattern": "Write", "permission": "ask"},
      {"tool_pattern": "Edit", "permission": "ask"},
      {"tool_pattern": "Bash", "permission": "ask"}
    ]
  }
}

---

Configuration

Global (~/.autobots/settings.json):

{
  "permissions": {
    "default": "ask",
    "rules": [
      {"tool_pattern": "Read", "permission": "allow"},
      {"tool_pattern": "Write", "permission": "ask"}
    ]
  }
}

Project (.autobots/settings.json):

{
  "permissions": {
    "rules": [
      {"tool_pattern": "Bash(npm test)", "permission": "allow"},
      {"tool_pattern": "Bash(rm *)", "permission": "deny"}
    ]
  }
}

Environment Variables:

$env:AUTOBOTS_ALLOWED_TOOLS = "Read,Glob,Grep"
$env:AUTOBOTS_DENIED_TOOLS = "Bash(rm *)"

---

Environment Variables

---

1. Set your API key

$env:NVIDIA_API_KEY = "your_key_here"

CLI Commands

---

[PASS] API Key: NVIDIA_API_KEY set (ends with ...abc1)

[PASS] Connectivity: NVIDIA API reachable

Hooks & Extensions

• Pre/Post Tool Hooks — Run scripts or callbacks before/after tool execution
• Abort on Failure — Hook failure stops the tool chain
• MCP Integration — Connect to Model Context Protocol servers for custom tools
• Command Hooks — Shell commands with env injection and 30s timeout

Workflow

• Session Management — Durable checkpoints, resumable runs, audit trails
• Configurable Modes — Supervised, milestone, or fully autonomous execution
• Multi-Root File Writing — Write to src/, app/, lib/, tests/, docs/, scripts/
• Validation Commands — Run tests, linters, and build commands automatically
• Shell Completions — bash, zsh, and fish tab completion
• Plugin System — before/after hooks for custom extensions
• Skill Marketplace — Built-in packs for FastAPI, Django, React, Next.js
• Web Dashboard — Real-time status on port 8080

---

MCP Integration

Connect to Model Context Protocol servers:

from autobots.mcp import MCPClient

client = MCPClient(command="npx", args=["-y", "@modelcontextprotocol/server-filesystem"])
client.connect()
tools = client.list_tools()
result = client.call_tool("read_file", {"path": "/etc/hosts"})

---

Troubleshooting

---