Meet Your Empire's Most Dedicated Employee.
Stellaris Companion watches your save file, chronicles your empire's history, and gently explains why your economy is on fire. Part helpdesk. Part historian.
◈_
◈_
Every Empire Deserves a Historian
A chapter-by-chapter history of your empire that writes itself as you play. Wars end, chapters close. Crises arrive, new eras begin. It does the paperwork. You do the war crimes.
- Adapts its voice to your ethics — Militarists get war epics, Spiritualists get scripture
- Permanent chapters that accumulate across sessions — your first era is still there 200 years later
- Tracks 20+ event types: wars, first contact, ascension perks, ruler changes, crises
- Rewrite history — regenerate any chapter if you want a different take
- Persists per save file — close the game, come back next week, your Chronicle is waiting
The year was 2200. Humanity stood at the precipice of the stars, united under the banner of the United Nations of Earth. The discovery of hyperlane travel had transformed Sol from a cradle into a launchpad.
President Chen addressed the Assembly: the age of expansion had begun. Three science vessels departed Sol within the first standard year, their crews cataloguing anomalies that would reshape humanity's understanding of the galaxy.
The UNS Discovery charted the Sirius approach. The UNS Horizon mapped the Procyon corridor. And the UNS Pathfinder — she found something else entirely.
The Galactic Help Desk
It doesn't play the game for you. It just points out what you missed while staring at the galaxy map for 4 hours.
- Reviews your economy and explains, patiently, why you're out of alloys
- Compares your fleet to the Crisis — you decide how to feel about the numbers
- Matches its tone to your ethics — a Fanatic Purifier advisor doesn't suggest diplomacy
- Personality is adjustable. Helpful colleague and insubordinate are both valid instructions
Consult Without Alt-Tabbing
Your advisor is available in the Discord overlay, in any channel, or from your phone on the couch. It doesn't judge where you command your empire from.
two empires just declared war on me at the same time
"Yes, Grand Admiral, I see them. Combined hostile fleet power: 215k. You field 40k on a naval capacity of 220, which means you could field three times the navy you currently possess. Alloy production is 180/month and your three shipyards are doing nothing in particular. The good news is you can afford a war fleet. The bad news is you don't have one yet. I recommend building it before they arrive, which will be soon."
Patch & DLC Awareness
Stellaris has had four major overhauls since the data most AI models were trained on. Stellaris Companion doesn't guess—it reads your save file and your game version.
How It Works
Everything happens on your machine. We process your save, extract the important bits, and send a structured briefing to Gemini using your API key. We never see it — and frankly, we don't want to know what you did to those xenos. Here's what we extract:
Economy
Resources, budgets, deficits, trade value, market prices, pop jobs
Military
Fleet power, ship composition, naval capacity, starbases, wars
Diplomacy
Relations, treaties, federations, rivals, subjects, closed borders
Technology
Completed techs, research queue, traditions, ascension perks
Leadership
Admirals, scientists, governors, traits, levels, ruler changes
Territory
Colonies, planet health, districts, buildings, archaeology sites
Endgame
Crisis detection, Fallen Empires, Great Khan, War in Heaven, L-Gate
History
50+ event types, campaign memory, session recaps, megastructures
No accounts. No ads. Open source.
Get the App
Free, open-source desktop app for Windows, Mac, and Linux. Your empire's paperwork isn't going to file itself.
We built this because we wanted it to exist. Help us make it good. GitHub →
Frequently Asked
FAQ.014- Is this a mod?
- No. Stellaris Companion is a standalone desktop app that reads your save files externally. It never touches your game installation, doesn't break checksum, and your achievements still work.
- Does it work with Ironman mode?
- Yes. Because the app only reads your save file and never writes to it, Ironman mode is fully supported. No checksum issues, no achievement locks.
- Does it cost money?
- Free and open source. You just need a Google Gemini API key, which is free within Google's generous usage limits. No subscriptions, no paywalls.
- Why Gemini? Can I use other models?
- Gemini has a generous free tier, which means you can use the Companion without paying for anything. It also lets us tune and test against one model's Stellaris knowledge so the advice is actually reliable. We're planning to add more options — including other cloud models and local models — but we'd rather ship one that works well than five that hallucinate your fleet power.
- Is this a cheat tool? Will it spoil the game?
- No. It's a strategy advisor and chronicler — it doesn't automate gameplay or modify save files. Most analysis is player-centric (your empire, your economy, your known contacts), but because it reads the full save file, it can occasionally surface galaxy-wide information like active crises or fleet benchmarks earlier than normal in-game discovery. Think of it as a well-briefed science officer who sometimes knows a bit more than they should.
- What data is sent to the AI?
- Your raw save files never leave your computer. The app parses them locally with a Rust-based parser, then sends a structured text briefing (empire stats, events, ethics) to the Gemini API using your own key. If you use the Discord bot, your questions and the advisor's responses pass through a stateless Cloudflare relay, but no game state or save data is included. We never see your data.
- Does it work with mods?
- Yes. The parser handles modded saves. Extremely complex total conversions might have minor quirks, but core features like Chronicle and Economy Analysis work across most popular mods.
- Does it work with Hive Minds and Machine Intelligences?
- Yes. The advisor has dedicated personality modes for Gestalt Consciousness empires. Hive Minds get collective 'we' language, Machine Intelligences get cold efficiency metrics and logic-driven analysis.
- Which platforms are supported?
- Windows, macOS, and Linux. The companion is an Electron-based desktop application that runs alongside your game.
- Windows shows a security warning?
- The macOS build is fully signed and notarized by Apple, so it installs cleanly. The Windows build isn't code-signed yet, so SmartScreen will flag the installer. The app is fully open-source if you want to see what it's doing. Click 'More info' then 'Run anyway.' We're working on signing and Windows Store distribution.
- Can it help during the endgame Crisis?
- Yes. It detects all three endgame crises (Prethoryn, Contingency, Unbidden), the Great Khan, Fallen Empire awakenings, and the War in Heaven. It benchmarks your fleet power and production capacity against the threat and tells you how ready you are.
- Can I export my chronicle?
- Yes. You can export your full chronicle directly from the app — handy if you want a readable record of the campaign after it's over.
- What does the Discord bot send through your servers?
- Only the text of your question and the advisor's response. The relay is a stateless Cloudflare Worker that connects Discord to your local app via WebSocket. Responses are ephemeral and only visible to you.
- Do you collect analytics or telemetry?
- No. The app does not collect telemetry, analytics, or anonymous usage data. The only network requests beyond your Gemini API calls are checking for app updates and fetching a public announcements feed from GitHub — both read-only, no user data sent. This website uses Google Analytics for basic, anonymous usage statistics (pageviews and link clicks), as described in the privacy policy.
- What happens when I submit a bug report?
- The app captures diagnostic context (app version, empire name, game year, DLCs, and optionally a screenshot) and shows you everything before sending. You choose the category, write a description, and review all fields. The report is sent to a Cloudflare Worker that creates a GitHub issue. Nothing is sent without your explicit action.