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.

DeskRPG logo

Self-host DeskRPG

2026.1019.1

3D virtual office where Hermes AI agents work as employees

ReleaseSource AvailableOther
Updatedlast week
LanguageTypescript
Setup difficultyModerate
Stars
194
RAM
8 GB recommended
Ports
3000 (HTTP web interface), 3001 (WebSocket / real-time)
Requires
Deskrpg-hermes-plugin, Hermes Agent
Docker
ghcr.io/dandacompany/deskrpg
Install with Docker Compose
DeskRPG home screenDeskRPG 3D office morning commuteDeskRPG agent called over, walking to the player to reportDeskRPG live office small talkDeskRPG agent meeting

What is DeskRPG?

DeskRPG gives you a browser-based 3D office where each Hermes Agent profile you already run becomes an AI coworker. These NPCs occupy desks, respond when you @-mention them, join meetings with speaker tracking, execute kanban cards owned by Hermes, and run cron schedules you manage from the UI. The app does not include an agent runtime; you point it at a Hermes gateway you host yourself, so there is no migration for existing Hermes users. Deployment options include a simple npm command, several Docker Compose variants (PostgreSQL, SQLite, or a combined stack with Hermes), and a one-click Hostinger VPS install. The office features 50 character appearances, five themed maps, file sharing in conversations and meetings, and multiplayer with role-based access in four languages. Licensing is a custom Sustainable Use License that allows self-hosting and provider one-click installs but prohibits offering DeskRPG as a managed service.

Should you self-host DeskRPG?

DeskRPG scores 44/100 on selfhost.directory (how scoring works) and ranks #146 of 209 in AI Agents. It has 194 GitHub stars.

It shipped 10 stable releases in the past year. The latest, 2026.1019.1, came out on 19 October 2026. New versions land roughly every 1 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Other-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 DeskRPG vs Orca side by side.

Features

  • 3D Virtual Office
  • AI Meetings
  • AI NPCs (Hermes Profiles)
  • Character Customization
  • Cron Jobs / SchedulesRequires deskrpg-hermes-plugin
  • File Uploads in Chat/MeetingsRequires plugin 0.32.0
  • Hermes Gateway Discovery
  • Kanban BoardsRequires deskrpg-hermes-plugin 0.32.0+
  • Multiplayer with Role-Based Access
  • Real-time Chat with Mentions

DeskRPG README

How to install DeskRPG

Install DeskRPG with Docker Compose

Docker, Docker Compose
Environment variables
JWT_SECRET, POSTGRES_PASSWORD, DESKRPG_IMAGE, COOKIE_SECURE

git clone https://github.com/dandacompany/deskrpg.git cd deskrpg printf 'JWT_SECRET=%s\nPOSTGRES_PASSWORD=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 16)" > .env.docker docker compose --env-file .env.docker -f docker/docker-compose.external.yml up -d

Opens on http://localhost:3102. Recommended for multiple users or durable database.

How to configure DeskRPG

  • COOKIE_SECUREfalseWhether to use secure cookies (HTTPS only)

    Whether to use secure cookies (HTTPS only)

    values: true/false

  • DATABASE_URLpostgresql://deskrpg:${POSTGRES_PASSWORD:-deskrpg_dev_pw}@deskrpg-db:5432/deskrpgPostgreSQL connection URL

    PostgreSQL connection URL

  • DB_TYPEDatabase type: postgresql or sqlite

    Database type: postgresql or sqlite

    values: postgresql/sqlite

  • DESKRPG_FEEDBACK_URLhttps://feedback.deskrpg.comWhere surveys and private bug reports go; empty to disable

    Where surveys and private bug reports go; empty to disable

  • DESKRPG_HOME/app/data/homeHome directory for generated JWT_SECRET persistence

    Home directory for generated JWT_SECRET persistence

  • DESKRPG_HOST_SETUP_ENABLEDonEnable local/SSH gateway setup wizard for system_admin

    Enable local/SSH gateway setup wizard for system_admin

    values: 0/1

  • DESKRPG_IMAGEghcr.io/dandacompany/deskrpg:latestDocker image reference to use (pin to specific release tag)

    Docker image reference to use (pin to specific release tag)

  • DESKRPG_LOCAL_DISCOVERY_ENABLEDoffLet a loopback gateway read ~/.hermes/profiles on the host

    Let a loopback gateway read ~/.hermes/profiles on the host

    values: 0/1

  • HERMES_API_KEYAPI key for Hermes gateway authentication

    API key for Hermes gateway authentication

  • INTERNAL_HOSTNAME0.0.0.0Internal hostname binding

    Internal hostname binding

  • JWT_SECRETSecret key for JWT token signing; generated automatically if not set

    Secret key for JWT token signing; generated automatically if not set

  • POSTGRES_PASSWORDdeskrpg_dev_pwPassword for PostgreSQL database (Docker PostgreSQL setup)

    Password for PostgreSQL database (Docker PostgreSQL setup)

  • SQLITE_PATH/app/data/deskrpg.dbPath to SQLite database file

    Path to SQLite database file

DeskRPG releases & version history

More in Collaboration

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…