Get started
Two commands and a browser tab.
Install Prokop, initialize your workspace, connect a model, and start your first session.
1. Install
Pick your platform. The copy button grabs the active command.
The installer downloads the latest binary to ~/.prokopai/bin/prokop (on Windows: %USERPROFILE%\.prokopai\bin\prokop.exe) and adds it to your PATH.
2. Set up and open
prokop init does the whole first run: creates the standard directories under ~/.prokopai/, sets up the SQLite database, installs the bundled agents, starts the daemon on port 8742, and opens the client in your browser. The coding tools agents need are built into the binary. Nothing else to install.
3. Connect a model
In the client that just opened, go to Settings → Providers & Models. Each provider has its own card: paste an API key or sign in with a supported subscription, then choose your default model. You can still pick a different model per session.
Connect a provider and choose a default model → Written steps for subscriptions and API keys.
- API key: OpenRouter, DeepSeek, MiniMax, Z.AI (Coding Plan)
- Subscription: Codex (ChatGPT)
- Gateway: OpenRouter accepts provider/model IDs supported by its API
- Claude Code or Codex CLI: if the CLI is installed and logged in on this machine, pick Claude or Codex in the model picker. No provider setup needed. Use your Claude Code or Codex login →
You never need to touch a .env file for this flow. API keys can also live there alongside server settings such as the auth token or TLS described in the docs.
4. Start a session
On first launch, Prokop creates a virtual workspace in a UUID-named directory under ~/.prokopai/workspaces. You don't need to add a project to start.
- Use the virtual workspace already available.
- Pick a model, and an agent if you want one other than the default.
- Start chatting. The agent can read, edit, search, and run commands right away.
Want to work on an existing project instead? Add your local project folder → This optional walkthrough takes 19 seconds.
Everyday commands
The daemon keeps running when you close the terminal or the browser tab. To use it from your phone or another computer, turn on remote access in Settings → Devices and pair the device first.
Where to go next
- How-to guides: short videos and written steps for specific tasks
- Documentation: behavior, settings, and commands
- Configuration reference: models, providers, server settings, compaction
- Workspaces and sessions: memory, skills, goals, subagents