Skip to content

Give a Multi-Modal LLM full access of your linux computer

License

Notifications You must be signed in to change notification settings

vmerckle/Aifor-Loop

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Full computer control with a simple CLI script

Python 3.10+ License: MIT Code style: black

Surrender.py lets Claude(Computer Use) take control of your machine through a tool-based interface.

demo.mp4

There are no safety features. Run at your own risks. You need an Anthropic API key and around 0.15€ to reproduce the video above.

Features

  • 🏳️ No safety features (CTRL-C should work)
  • Screenshot-Click debugging: logs where Claude clicked
  • 🖥️ Full computer control (mouse, keyboard, screenshots)
  • 🔧 Bash command execution & 📝 File editing capabilities

Installation

git clone https://github.com/vmerckle/Aifor-Loop.git
cd Aifor-Loop ; pip install -r requirements.txt

Only if your API key is not exported:

echo ANTHROPIC_API_KEY = "your api key here" > .env

Usage

python surrender.py "Apply for some machine learning jobs, but please don't delete my home folder by accident"

Requirements

  • Python 3.10+
  • Anthropic API key
  • Linux with X11 (for computer control features)
  • Required system packages:
    • xdotool
    • scrot or gnome-screenshot
    • imagemagick

Install system requirements on Fedora:

sudo dnf install xdotool scrot imagemagick

Environment Variables

Variable Description Required
ANTHROPIC_API_KEY Your Anthropic API key Yes
WIDTH Screen width in pixels No
HEIGHT Screen height in pixels No
DISPLAY_NUM X11 display number No

Architecture

Aifor-Loop uses a tool-based architecture where Claude can only interact with your computer through well-defined tool interfaces:

  • ComputerTool: Screen, keyboard, and mouse control
  • BashTool: Command execution
  • EditTool: File operations

Acknowledgments

About

Give a Multi-Modal LLM full access of your linux computer

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages