Read-only analyzer
Not a save editor
The Companion reads the file but never writes changes back to it.
File Audit // Read Only
Stellaris Save Analyzer.Your Empire's Performance Review.
Stellaris Companion reads your local .sav file, turns it into a structured campaign briefing, and lets you ask what your economy, fleets, planets, and neighbors are trying to tell you. It never edits the save. The paperwork is strictly observational.
Free & open sourceIronman-safeGemini API key required
LOCAL FILE // ADVISOR READYSystems online
Terms of Service
Analysis, not save editing.
The Companion is interested in your decisions, not in secretly making them for you. The checksum may remain calm.
Local desktop app
Not a web upload form
The raw .sav stays on your machine and is parsed there.
Strategic briefing
Not a raw-data browser
It explains what the numbers mean and recommends what to inspect next.
Campaign memory
Not one static report
Successive saves build a history of changes, events, and decisions.
Evidence // UNE 2447.01.01
One save. Three uncomfortable questions.
These are abridged responses produced by the current Advisor against a representative United Nations of Earth campaign save. The names and figures below came from that parsed file; the prose has been shortened for display.
ECON.01
CMD_INPUT
“What is hurting my economy right now?”
Your economy is suffering from a Consumer Goods deficit of −95.28 monthly. Overall production is robust, but this is the only resource drain. Review planetary designations and convert one suitable industrial world toward civilian production before the stockpile masks a persistent shortfall.
Modules: ECONOMY · PLANETS · RESOURCE FLOW
MIL.02
CMD_INPUT
“Could this empire handle a major war right now?”
With more than 360,000 fleet power, 13 fleets, +2,269 alloys per month, three defensive pacts, and a 379,710 alloy stockpile, the empire is in a strong position for sustained conflict. Naval capacity is uncertain, but the save indicates ample reinforcement capacity.
Modules: MILITARY · DIPLOMACY · READINESS
PRI.03
CMD_INPUT
“What am I probably neglecting?”
Consumer Goods remain the persistent risk: −95.28 per month while a war with the Steccashi Conservers is active. Convert part of industrial production to civilian goods so high-tech jobs can continue without steadily consuming the stockpile.
Modules: PRIORITY · INDUSTRY · ACTIVE WAR
Different empire. Different problems. Same filing procedure.
Contents of File
What can a Stellaris save analyzer tell you?
Quite a lot. Some of it could probably have remained classified.
EC
Economy
Resources, monthly income, deficits, stockpiles, trade value, market prices, and pop jobs.
ML
Military
Fleet power, ship composition, naval usage, starbases, active wars, and known threats.
DP
Diplomacy
Relations, allies, rivals, treaties, federations, subjects, and closed borders.
TC
Technology
Completed technologies, current research, traditions, repeatables, and ascension perks.
LD
Leadership
Rulers, admirals, scientists, governors, traits, levels, and leadership changes.
TR
Territory
Colonies, planet health, systems, districts, buildings, and archaeology sites.
EG
Endgame
Crises, Fallen Empires, the Great Khan, the War in Heaven, and other late-game signals.
HS
History
Campaign snapshots, wars, contacts, rulers, policies, megastructures, and major events.
Intake Protocol
From save file to strategic briefing.
Four steps. No upload ritual. No attempt to improve your empire by editing history after the fact.
01
Find the save
The app watches the normal Stellaris save folders and selects the newest .sav, or you can choose a folder yourself.
02
Parse it locally
A Rust-based parser opens the save on your machine and extracts the campaign state without changing the source file.
03
Build the briefing
The useful parts become structured context: economy, military, diplomacy, planets, technology, history, and more.
04
Ask the awkward question
Gemini receives the structured briefing through your API key and answers about this empire rather than a hypothetical one.
Chain of Custody
Your raw save stays at home.
We do not need custody of the empire's personnel file. The useful distinction is between the raw save and the structured briefing created from it.
Read the full privacy policy →Raw .sav file
Parsed locally. Never uploaded by Stellaris Companion.
Structured briefing
Sent to Gemini for built-in Advisor questions using your own API key.
Original save
Read only. Never edited, replaced, or written back to.
Campaign history
Stored locally so the app can compare saves over time.
Accounts and ads
None. The project is free and open source.
Current Status
Facts updated 2026-07-31Read-only by design. Ironman-safe by consequence.
Stellaris4.4 “Pegasus”
Patch knowledgeThrough 4.4.6
Companionv0.8.5
PlatformsWindows · macOS · Linux
Languages7 supported
Game changesNone. No mod required.
Suggested Inquiries
Ask about the campaign you actually have.
The Advisor does not need you to translate the empire into a spreadsheet first. That administrative position has been filled.
- 01Why is my Stellaris economy losing energy?
- 02Which planet should I fix first?
- 03Is my fleet strong enough for a major war?
- 04Who is my most dangerous known neighbor?
- 05Am I ready for the endgame Crisis?
- 06What changed since my previous save?
- 07What should I prioritize over the next decade?
- 08What am I probably neglecting?
Questions
The practical bits.
Save locations, Ironman, Steam Cloud, mods, privacy, and the entirely reasonable question of why an AI advisor needs an AI key.
- What is a Stellaris save analyzer?
- A Stellaris save analyzer reads information stored in a .sav file and turns it into something easier to inspect. Stellaris Companion is a read-only desktop analyzer: it parses the save locally, builds a structured campaign briefing, and lets an AI advisor explain your economy, military, diplomacy, planets, technology, and campaign history.
- Can it analyze Ironman saves?
- Yes. The same read-only parser works with regular and Ironman saves. Stellaris Companion never modifies the save or game installation, so it does not alter the checksum or disable achievements.
- Does Stellaris Companion edit save files?
- No. It is a save analyzer and strategic advisor, not a save editor. It reads the original file and stores its own local briefing and history separately.
- Is my Stellaris save uploaded?
- No raw save file is uploaded. Parsing happens on your machine. For the built-in Advisor, a structured text briefing and your question are sent to Gemini using your API key. The raw .sav remains local.
- Where are Stellaris save files located?
- The usual folders are Documents\Paradox Interactive\Stellaris\save games on Windows, ~/Documents/Paradox Interactive/Stellaris/save games on macOS, and ~/.local/share/Paradox Interactive/Stellaris/save games on Linux. Stellaris Companion normally detects these folders automatically, and you can override the location in Config.
- Can it analyze Steam Cloud or GeForce Now saves?
- Yes, once the .sav is available locally. Steam normally synchronizes saves into a local Stellaris save folder. For GeForce Now or another cloud-only setup, download the save from Steam Remote Storage and point Config to that folder.
- Does it work with modded saves?
- The parser handles modded saves and the core Advisor and Chronicle features work with most mods. Extremely complex total conversions can introduce fields or mechanics the current extractor does not fully understand, so occasional quirks are possible.
- Which Stellaris version is supported?
- The current compatibility target is Stellaris 4.4 “Pegasus”, with bundled patch knowledge through 4.4.6. Compatibility facts are updated from the same product data used by the homepage and release workflow.
- Is the Stellaris save analyzer free?
- Yes. Stellaris Companion is free and open source for Windows, macOS, and Linux. The built-in Advisor requires your own Google Gemini API key; Google provides a free usage tier, subject to its current limits.
Begin Audit
Open your own file. Ask the worrying question.
Free and open source for Windows, macOS, and Linux. Compatible with Ironman. Gemini API key required for the built-in Advisor.
Independent fan project · Not affiliated with Paradox Interactive