Operator is an AI agent you message from anywhere Telegram, Discord, Slack, or Twitch and it works on your computer. It reads files, browses the web, runs commands, clicks through apps, and remembers who you are. It runs locally, connects to any LLM, and gets smarter over time.

Inspired by nanobot and OpenClaw. Thanks for these wonderful projects.

Key Features

🖥️ Desktop Control — Click, type, scroll, take screenshots, and open apps via native accessibility APIs (Windows UIA, macOS Accessibility (Beta), Linux (in progress)).

🌐 Web Browsing — Search, navigate, and extract content from the web.

💬 Multi-Channel — Message it through Telegram, Discord, Slack, Twitch, or MQTT.

🧠 Memory — Remembers you, your preferences, and past conversations across sessions.

📅 Scheduling — Cron-based recurring tasks and a heartbeat system for proactive work.

🎙️ Voice I/O — Full STT and TTS support across multiple providers.

🔌 Any LLM — Works with OpenAI, Anthropic, Google, Mistral, Groq, Ollama, and many more.

Table of Contents

• Install
• Quick Start
• Channels
• Supported LLMs
• Voice (STT / TTS)
• CLI Reference
• Docker
• Contributing
• Security
• Citation
• Star History
• License

📦 Install

Try it instantly (no install needed — runs setup on first launch):

uvx operator-use

Install permanently (then just type operator every time):

uv tool install operator-use
operator

With pip:

pip install operator-use
operator

First run automatically launches the setup wizard. After that, operator starts your agent directly.

Update

uv tool upgrade operator-use
# or
pip install -U operator-use

uv tool upgrade operator-use

🚀 Quick Start

1. Run the setup wizard

operator onboard

This walks you through choosing an LLM provider, entering your API key, and connecting a messaging channel.

2. Start the agent

operator

That's it. Message your bot and it will start working.

💬 Channels

Connect Operator to the platform you already use:

operator onboard

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "allow_from": ["YOUR_USER_ID"]
    }
  }
}

operator run

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "allow_from": ["YOUR_USER_ID"]
    }
  }
}

operator

{
  "channels": {
    "slack": {
      "enabled": true,
      "bot_token": "xoxb-...",
      "app_token": "xapp-..."
    }
  }
}

operator run

{
  "channels": {
    "twitch": {
      "enabled": true,
      "token": "oauth:YOUR_TOKEN",
      "nick": "your_bot_username",
      "channel": "your_channel_name"
    }
  }
}

operator run

🤖 Supported LLMs

Operator works with any of these providers:

Configure your provider during operator onboard or in your config file.

🎙️ Voice (STT / TTS)

🖥️ CLI Reference

operator onboard     Interactive setup wizard
operator run         Start the agent
operator agent       Agent configuration
operator gateway     Manage channels
operator channels    List active channels
operator models      List available models
operator sessions    View conversation sessions
operator status      Show system status
operator logs        Stream logs

🐳 Docker

docker build -t operator .
docker run --env-file .env operator

Exposed ports:

Contributing

Contributions are welcome! Please read CONTRIBUTING.md for branch strategy, dev setup, code style, and PR guidelines.

Security

To report a vulnerability, please follow the steps in SECURITY.md. Do not open a public issue for security concerns.

Citation

If you use Operator-Use in your research or project, please cite it as:

@software{operator_use_2026,
  author    = {CursorTouch},
  title     = {Operator-Use: An AI Agent That Operates Your Computer},
  year      = {2026},
  url       = {https://github.com/CursorTouch/Operator-Use},
  license   = {MIT}
}

Star History

License

This project is licensed under the MIT License.