open-webui/open-terminal
CODE EXECUTION SERVER FOR AI AGENTS
Self-hosted REST API for running commands, managing files, and executing code by AI agents. Connects to Open WebUI or works standalone via HTTP/WebSocket.
// KEY FEATURES
- Run commands, files, code, browser and desktop via REST API
- Docker images: full, agents (Codex/Claude), CUDA, slim, alpine
- Private IPC via Unix sockets or Windows named pipes
- Open WebUI integration: terminal and file browser in chat
// DEEP DIVE: HOW IT WORKS
Open Terminal provides a self-hosted HTTP server that gives AI agents access to a full computer environment: shell command execution, filesystem operations, Python/Node.js code execution, browser and graphical desktop control. Interaction happens via REST API and WebSocket with API key authentication; the server can run in Docker or directly via Python 3.11+.
The project ships with six Docker images for different tasks: `latest` with full toolkit (Python, Node, build tools, browser, desktop), `agents` with added Codex and Claude Code CLIs, `cuda` with GPU support, `slim`/`alpine` for minimal containers, and `openshift` for restricted policies. Differentiation from alternatives — built-in desktop sessions (XFCE/GNOME) and private IPC mode without opening TCP ports, plus native Open WebUI integration with terminal panel and file browser.
Requires Linux/macOS/Windows with Python 3.11+; Docker desktop uses XFCE, GNOME enabled via flag. API key is mandatory — a random one generates at startup if absent. On bare metal commands run as the user who started the server, so access must be granted only to trusted agents. Container updates preserve files via mounted volume.
// USE CASES
Best for: AI agent developers needing an isolated execution environment
- Connect AI agent to isolated code execution and file operations environment
- Run Codex or Claude Code in container and control them via Open WebUI chat
- Give LLM browser and desktop access for GUI automation without opening ports
// QUICK START
uvx open-terminal@latest run --host 0.0.0.0 --port 8000 --api-key your-secret-keyCommands are taken from the repository README — check the current version on GitHub before running.
New repositories every 30 minutes
REDDYX AI scans GitHub 24/7 and ships the best AI/ML/Web3 projects to Telegram.
Join on Telegram