Podocracy local worker portal

Run voiceover translation on your own machine

Podocracy now ships as a local desktop app and Docker Compose worker portal. You keep project files on your computer, use your own provider keys, and avoid paying for hosted compute that sits idle between projects.

Start here: desktop app, no terminal

Install and start Docker Desktop once.
Create an OpenAI API key at platform.openai.com/api-keys.
Download the latest Podocracy build from GitHub Releases.
Open the app and paste your OpenAI key when asked.

The app checks Docker, lets you adopt an existing setup or create a new ~/Podocracy folder, writes the configuration, starts the containers, and opens http://localhost:8080. After that, just open Podocracy again from your Dock or Taskbar.

Downloads

macOS: download Podocracy-macos-<version>.zip, unzip it, then right-click Podocracy.app and choose Open the first time.
Windows: download Podocracy-windows-<version>.zip, unzip it, then double-click Podocracy.cmd. If SmartScreen warns, choose More info → Run anyway.

Command line & developers

Prefer the terminal, Linux, Colima, or building from source? Use the prebuilt-image Docker Compose setup instead.

mkdir -p "$HOME/podocracy-worker-portal/projects"
cd "$HOME/podocracy-worker-portal"
curl -fsSLO https://raw.githubusercontent.com/cloudsecmentor/podocracy-app/main/docker-compose.images.yml
curl -fsSLO https://raw.githubusercontent.com/cloudsecmentor/podocracy-app/main/.env.example
cp .env.example .env
# edit .env and set OPENAI_API_KEY
docker compose -f docker-compose.images.yml up -d

Open http://localhost:8080 when the containers are ready.

Update later

docker compose -f docker-compose.images.yml pull
docker compose -f docker-compose.images.yml up -d

Project files stay in ./projects unless you set PODOCRACY_PROJECTS_DIR.

Download latest release Open GitHub README Back