Do I need to install anything else?
No. The desktop app and the Android app bring everything they need: no Node.js, no setup script, no terminal. The desktop app downloads the world map the first time it opens, and the Android app carries it inside. The one thing you supply is an AI — see Connecting an AI Provider.
Is it really free?
Yes. Open Historia is free and open source under the GNU AGPL v3. The AI features connect to an AI provider you choose — see Connecting an AI Provider or ask in Discord for setup help.
Which AI can I use?
Gemini, OpenAI or Anthropic with your own key; any service that speaks OpenAI's or Anthropic's API, such as OpenRouter; or a model running on your own computer through Ollama or LM Studio. A Fallback list of backup models takes over when one is busy or out of allowance. In the beta's desktop app, your own Agent (Claude Code, Codex, OpenCode or Antigravity CLI) can answer what you start instead. More in AI Providers and Models.
Where does it run — is my data uploaded?
On your own device: the desktop app in its own window, the Android app on your phone, the browser version in your browser. Your saves and scenarios stay on your device, and your AI key goes only to the AI provider you choose. Visits are counted only if you say yes. The privacy policy lists everything the game contacts.
What licence are shared scenarios under?
Every scenario made in Open Historia that is posted or shared in any way is released under the Creative Commons Attribution 4.0 International licence (CC BY 4.0). The game says so before you publish and writes it into the file.
How do I update later?
The desktop app updates itself. When it opens, it installs a waiting update first — only the parts of the app that changed, or the whole installer when a release needs it — and restarts on the new version; choose Open the game now instead and the update installs when you close the game. An update that comes out while you play shows as a banner at the top: Update now, then Restart now. Your saves, scenarios and map are kept. On macOS, where the app is not code-signed yet, an update that needs the whole app is offered as a download instead. The Android app shows the same banner and fetches the new version for you to install, and the browser version reloads onto it. The beta is a separate app that updates itself the same way, from its own releases. A copy run from the source code updates the way it was installed: pull the newest code, then run npm install and npm run build again.
What is the beta?
The game's newest version, ahead of the stable one and less tested. It is a separate app, Open Historia Beta, with its own saves, and installs beside the stable app on Windows, macOS, Linux and Android. New features come to it first: shared games are there now. Its download sits under each stable one above, and the stable desktop app offers it after it is installed and after each update.
What about mobile?
Download the Android APK and open it — that is the whole setup. Your games live on the phone and the whole world map is inside the app, so it plays even in airplane mode, with no server to run and nothing to point it at. The beta Android app installs beside it. On iPhone and iPad, play the browser version in Safari.