LibreAI / Dev Tools / open-terminal
// devtools · open-webui/open-terminal

open-terminal

Open Terminal — a computer you can curl: a sandboxed terminal API for AI agents, from Open WebUI.

★ 3.3k stars⑂ 291 forksMITupdated 2026-09
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

open-terminal is an open-source dev tools project by open-webui (open-webui/open-terminal on GitHub). It has 3,282 GitHub stars and 291 forks, is released under the MIT license, and was last updated on GitHub on 23 September 2026.

GitHub stars
3,282
Forks
291
License
MIT
Last updated on GitHub
23 September 2026
Category
Dev Tools
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Decide the first concrete outcome you want from it, so you can pick the right example, template or mode instead of exploring everything at once.

  2. Get the project

    Clone the repository (or install the published package) and skim its README quick start for the requirements for your platform.

  3. Install and configure

    Run the documented install step and set any required configuration — such as provider keys, data sources or local services — before the first run.

  4. Run your first task

    Execute the smallest documented example end to end, confirm the output is what you expected, then adapt it to your real data or workflow.

// features

Why people love it

A terminal API for agents

A full computer exposed over HTTP for Open WebUI and other agent clients.

Sandboxed Docker mode

Isolated container with Python, Node.js, git, build tools, data-science libraries and ffmpeg pre-installed.

Bare-metal mode

pip/uvx install runs commands directly on your machine for local development and personal automation.

Customisable environment

Add system, pip and npm packages via environment variables at container start.

Open WebUI integration

Direct or system-level (multi-user) connection to Open WebUI, with a built-in multi-user mode.

API-key protected

Access is gated by OPEN_TERMINAL_API_KEY, with file-browser root and external workspace storage options.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the source so you can inspect, configure and run it locally.

    git clone https://github.com/open-webui/open-terminal.git
    cd open-terminal
  2. Run with Docker (recommended)

    Start the sandbox with your API key and a persistent volume.

    docker run -d --name open-terminal --restart unless-stopped -p 8000:8000 -v open-terminal:/home/user -e OPEN_TERMINAL_API_KEY=your-secret-key ghcr.io/open-webui/open-terminal  # see README for the exact image invocation
  3. Or run bare-metal with uvx

    No install needed — run it directly on your machine.

    uvx open-terminal run --host 0.0.0.0 --port 8000 --api-key your-secret-key
    # or: pip install open-terminal
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains open-terminal?

It is maintained by open-webui on GitHub (open-webui/open-terminal), where the source, issues and releases live.

Is it free to use?

Yes — it is free and open source under the MIT licence, which permits use, modification and redistribution, including commercially, with attribution.

Does it need a paid API key?

No LLM key is needed by Open Terminal itself; it serves whichever agent client (such as Open WebUI) you connect.

How does it compare to ad-hoc SSH access or a plain code-interpreter sandbox?

Compared with ad-hoc SSH access or a plain code-interpreter sandbox, open-terminal's distinguishing focus is: open Terminal — a computer you can curl: a sandboxed terminal API for AI agents, from Open WebUI. Pick it when that focus matches your need; the alternative may suit you better if its broader or different scope is the priority.

How do I get started?

Clone https://github.com/open-webui/open-terminal (or install its published package), follow the README quick start to install and configure it, then run the smallest documented example — the Run section on this page mirrors those steps.

// keep exploring

Similar tools

Dev Tools

destructive_command_guard

A guard that blocks dangerous git and shell commands before AI agents can execute them.

★ 6.1k starsMIT
View guide →
Dev Tools

mirage

A virtual terminal and filesystem that lets AI agents work across S3, Drive, Slack, Gmail and more.

★ 3.7k starsApache-2.0
View guide →
Dev Tools

MiMo-Code

Xiaomi's terminal-native AI coding assistant where models and agents co-evolve, with project memory.

★ 13.6k starsMIT
View guide →
Dev Tools

herdr

The terminal runtime your coding agents live on — a Rust multiplexer built for agent sessions

★ 42.9k starsApache-2.0
View guide →
Dev Tools

wigolo

Local-first web search, fetch, crawl and research for AI coding agents over MCP — no API keys.

★ 5.5k starsAGPL-3.0
View guide →
Dev Tools

formax

Terminal-first AI assistant designed for software engineering tasks (inspired.

★ 195 starsMIT
View guide →
// alternatives

Alternatives in Dev Tools

The most-starred other Dev Tools projects in the LibreAI catalogue — the realistic shortlist if open-terminal is not the right fit.

Get open-terminal

Free and open — grab the source, star the repo, and start creating.