Skip to main content

​
Install

pip install operator-ai
Or install from source: 
git clone https://github.com/geekforbrains/operator.git
cd operator
pip install -e .

​
Initialize

Create the ~/.operator/ directory structure with defaults: 
operator init
This creates:
  • ~/.operator/operator.yaml — runtime configuration
  • ~/.operator/SYSTEM.md — system preamble
  • ~/.operator/agents/operator/AGENT.md — default agent prompt

​
Configure

Edit ~/.operator/operator.yaml with your models and transport: 
defaults:
  models:
    - "anthropic/claude-sonnet-4-6"
  max_iterations: 25
  env_file: "~/.env"

agents:
  operator:
    transport:
      type: slack
      bot_token_env: SLACK_BOT_TOKEN
      app_token_env: SLACK_APP_TOKEN
Make sure your API keys are set in ~/.env: 
ANTHROPIC_API_KEY=sk-ant-...
SLACK_BOT_TOKEN=xoxb-...
SLACK_APP_TOKEN=xapp-...

​
Run

operator
Operator starts, connects to Slack, and begins listening for messages. Logs are written to ~/.operator/logs/operator.log.

​
Run as a Service

To run Operator in the background: 
operator service install   # create launchd/systemd service
operator service start     # start it
See the Service CLI for more details.

​
Next Steps

Configuration

Detailed configuration reference.

Agents

Create and customize agents.

Jobs

Set up scheduled tasks.

Skills

Extend agents with skills.