CodeRunner: Run AI Generated Code Locally

CodeRunner is an MCP (Model Context Protocol) server that executes AI-generated code in a sandboxed environment on your Mac using Apple's native containers.

Key use case: Process your local files (videos, images, documents, data) with remote LLMs like Claude or ChatGPT without uploading your files to the cloud. The LLM generates code that runs locally on your machine to analyze, transform, or process your files.

What CodeRunner Enables

| Without CodeRunner | With CodeRunner | | :--- | :--- | | LLM writes code, you run it manually | LLM writes and executes code, returns results | | Upload files to cloud for AI processing | Files stay on your machine, processed locally | | Install tools and dependencies yourself | Tools available in sandbox, auto-installs others | | Copy/paste scripts to run elsewhere | Code runs immediately, shows output/files | | LLM analyzes text descriptions of files | LLM directly processes your actual files | | Manage Python environments and packages | Pre-configured environment ready to use |

Quick Start

Prerequisites: Mac with macOS and Apple Silicon (M1/M2/M3/M4), Python 3.10+

git clone https://github.com/instavm/coderunner.git
cd coderunner
chmod +x install.sh
./install.sh

MCP server will be available at: http://coderunner.local:8222/mcp

Install required packages (use virtualenv and note the python path):