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.

GitHub
skrun logo

Self-host skrun

v1.2.1

Open-source multi-model runtime for AI agent skills as APIs

ReleaseOpen SourceMIT
Updated9 hours ago
LanguageTypescript
Setup difficultyModerate
Stars
210
RAM
~2 GB RAM
Ports
4000 (API server (registry)), 3000 (Local dev server (skrun dev))
Docker
ghcr.io/skrun-dev/skrun-runtime
Install with Docker Compose
Skrun Operator Dashboard — Home page showing workspace stats, recent activity, top agentsSkrun demo: push an agent, explore the dashboard, run it in the playground

What is skrun?

Skrun is an open-source runtime that lets you turn any AI agent skill into a callable HTTP endpoint. You define the agent using the Agent Skills format (SKILL.md) or AGENTS.md, add a YAML config for the model and tools, then deploy with a single command. The system supports six major LLM providers plus any OpenAI-compatible service, with automatic failover between them. It handles tool execution through local scripts and MCP servers, maintains persistent state across invocations, and streams results in real time via Server-Sent Events. A web dashboard gives you visibility into runs, costs, and agent versions. Authentication works through GitHub OAuth or API keys with isolated namespaces. Storage uses SQLite by default or PostgreSQL for production. The project is MIT licensed and the current release is v1.2.1.

Should you self-host skrun?

skrun scores 49/100 on selfhost.directory (how scoring works) and ranks #104 of 209 in AI Agents. It has 210 GitHub stars.

It shipped 12 stable releases in the past year. The latest, v1.2.1, came out on 23 September 2026. New versions land roughly every 9 days.

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

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

Features

  • Agent verification
  • Async webhooks
  • Caller-provided LLM keys
  • Environment separation
  • GitHub OAuth + API keys
  • Interactive API docs
  • Multi-model LLM support
  • Operator dashboard
  • Pluggable Storage
  • Private by default
  • SSE streaming
  • Stateful agents
  • Tool Calling
  • Typed SDK
  • Version pinning

skrun README

How to install skrun

Install skrun with Docker Compose

Environment variables
ANTHROPIC_API_KEY, OPENAI_API_KEY, GOOGLE_API_KEY, MISTRAL_API_KEY, GROQ_API_KEY, XAI_API_KEY, WEBHOOK_SIGNING_KEY, CORS_ORIGIN, POSTGRES_PASSWORD, S3_ACCESS_KEY_ID, S3_SECRET_ACCESS_KEY

git clone https://github.com/skrun-dev/skrun.git cd skrun cp .env.example .env

fill at least one LLM key

{ echo "POSTGRES_PASSWORD=$(openssl rand -hex 16)" echo "S3_ACCESS_KEY_ID=$(openssl rand -hex 8)" echo "S3_SECRET_ACCESS_KEY=$(openssl rand -hex 24)" } >> .env $EDITOR .env docker compose -f infra/docker-compose.yml up -d

Prod-parity stack with Postgres, MinIO, Redis, Caddy. Matches cloud topology.

skrun releases & version history

More in API Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…