whatisgithub

What is x4-analysis?

adammartinez271828/x4-analysis — explained in plain English

Analysis updated 2026-05-18

10PythonAudience · generalComplexity · 2/5Setup · easy

In one sentence

A fan tool that turns your X4: Foundations savegame into an interactive dashboard showing your empire's map, trade, and the game's market.

Mindmap

mindmap
  root((x4-analysis))
    What it does
      Reads X4 savegame
      Builds HTML dashboard
      Works fully offline
    Tech stack
      Python
      uv installer
    Dashboard tabs
      Sector map
      Trade analytics
      Market analysis
      Fleet view
    Use cases
      Track empire income
      Spot market gaps
      Review trade history
    Audience
      X4 Foundations players

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Visualize your X4: Foundations empire on an interactive sector map.

USE CASE 2

Track your empire's trade income and expenses over time.

USE CASE 3

Find profitable gaps in the game's universe-wide market to exploit for trading.

USE CASE 4

Browse the complete purchase and sale history of a station or ship.

What is it built with?

Pythonuv

How does it compare?

adammartinez271828/x4-analysisaarav90-cpu/fetchitalsgur9865-sketch/second-brain-engine
Stars101010
LanguagePythonPythonPython
Setup difficultyeasyeasymoderate
Complexity2/52/53/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

A no-install standalone build is available for Windows and Linux, or a one-command install via uv.

No license information found in the README.

So what is it?

This is a fan-made tool for players of the space trading game X4: Foundations. It reads your saved game file and turns it into a dark themed, tabbed dashboard you can open in your web browser, showing an interactive map of your in-game empire along with trade and market data. It is a Python rewrite and major expansion of an earlier tool built in the R programming language by another fan. Where that older version needed a huge amount of memory and several minutes to process a save, this one reads a large savegame in a single pass in just seconds. Getting started does not require installing Python at all. You can download a ready-to-run version for Windows or Linux from the project's releases page, or use a tool called uv to run it with one command. Once run, it automatically finds your most recent savegame, analyzes it, and opens a dashboard file in your browser. The dashboard works fully offline once generated, with no need for an internet connection. The dashboard has several tabs. A map tab shows an interactive view of the galaxy you can pan and zoom around, with details on stations, resources, and which faction controls each area. Trade tabs break down your empire's income and spending over time, by trading partner and by item. A market tab looks at supply and demand across the entire game universe, helping you spot where prices are unusually high or low so you can profit from the gap. Other tabs cover your fleet of ships and the wider universe's stations and factions. The tool includes reference data for the current version of the game and its official add-ons built in, so nothing extra needs to be downloaded for a standard installation. It can also pull in data for modded ships if asked to. Modded saves are supported and unrecognized ships or factions are handled gracefully rather than causing errors.

Copy-paste prompts

Prompt 1
Walk me through downloading and running x4-analysis to view my X4: Foundations savegame.
Prompt 2
Explain how to read the market tab in x4-analysis to find profitable trades.
Prompt 3
Help me set up x4-analysis to include data for modded ships in my game.
Prompt 4
What do the different tabs in the x4-analysis dashboard show me?

Frequently asked questions

What is x4-analysis?

A fan tool that turns your X4: Foundations savegame into an interactive dashboard showing your empire's map, trade, and the game's market.

What language is x4-analysis written in?

Mainly Python. The stack also includes Python, uv.

What license does x4-analysis use?

No license information found in the README.

How hard is x4-analysis to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is x4-analysis for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.