selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Understudy logo

Self-host Understudy

v0.3.0

Local AI agent that drives your desktop, browser and shell

BetaOpen SourceMIT
Updated10 hours ago
LanguageTypescript
Setup difficultyModerate
Stars
465
Port
23333 (Gateway background process (HTTP + WebSocket) that chat, dashboard, webchat and channels connect through)
Requires
Xcode Command Line Tools
Install with NPM

What is Understudy?

Should you self-host Understudy?

Understudy scores 48/100 on selfhost.directory (how scoring works) and ranks #110 of 209 in AI Agents. It has 465 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. It is MIT-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Orca (91/100, 108 739 stars). It scores higher overall, so compare the two before you pick. See Understudy vs Orca side by side.

Features

  • Automatic skill crystallizationLayer 3 partially implemented; promotion policy and automatic route upgrading still early
  • Bring your own model
  • Browser Automation
  • GUI automation (computer use)macOS only today; Linux and Windows planned
  • Learn by demonstration
  • Multi-channel messaging
  • Persistent memory
  • Playbook orchestration
  • Reusable skills
  • Shell command execution
  • Subagents
  • Task Scheduling
  • Web Dashboard
  • Web search and fetch

Understudy README

How to install Understudy

Install Understudy with NPM

npm install -g @understudy-ai/understudy understudy wizard # walks you through setup

Recommended: start the gateway daemon, then use the terminal

understudy daemon --start # Start the gateway background process (or: understudy gateway --port 23333) understudy chat # Terminal interactive mode (auto-connects to running gateway)

Also installable from GitHub Packages via an @understudy-ai registry entry in ~/.npmrc with a read:packages token. Native GUI automation and teach-by-demonstration require macOS today.

How to configure Understudy

  • ANTHROPIC_API_KEYAuth for Anthropic provider family (Claude models); OAuth also accepted

    Auth for Anthropic provider family (Claude models); OAuth also accepted

  • GEMINI_API_KEYAlternative auth key for Google / Gemini provider

    Alternative auth key for Google / Gemini provider

  • GOOGLE_API_KEYAuth for Google / Gemini models (GEMINI_API_KEY also accepted)

    Auth for Google / Gemini models (GEMINI_API_KEY also accepted)

  • MINIMAX_API_KEYAuth for MiniMax models; use the minimax-cn provider for the China endpoint

    Auth for MiniMax models; use the minimax-cn provider for the China endpoint

  • OPENAI_API_KEYAuth for OpenAI models (GPT-4.x, GPT-5.x, o-series); also used by OpenAI Codex, which accepts OAuth

    Auth for OpenAI models (GPT-4.x, GPT-5.x, o-series); also used by OpenAI Codex, which accepts OAuth

More in Automation

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…