git404hub

what is x4-analysis fr?

adammartinez271828/x4-analysis — explained in plain English

Analysis updated 2026-05-18

10PythonAudience · generalComplexity · 2/5Setup · easy

tl;dr

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

vibe map

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 make with this?

VIBE 1

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

VIBE 2

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

VIBE 3

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

VIBE 4

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

what's the stack?

Pythonuv

how it stacks up fr

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 i run it?

Difficulty · easy time til it works · 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.

in plain english

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.

prompts (copy fr)

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 fr?

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.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.