Skip to content

WilliamFalci/capsuleers.ia

Capsuleers.IA

An expert AI assistant for EVE Online — a standalone desktop app, cross-platform, 100% local and GPU-accelerated. Ask about skills, fitting, terminology, PVE missions, wormholes, sovereignty, exploration, industry and more, and get answers with cited sources, in Italian or English (auto-detected).

It runs entirely on your machine: a local LLM (via node-llama-cpp) answers using a RAG (Retrieval-Augmented Generation) index of EVE knowledge. No data leaves the computer, except optional lookups to public EVE APIs for the live-data features.

Download

Grab the installer for your OS from the Releases:

  • Windows, NVIDIA GPUCapsuleers.IA-Setup-NVIDIA_Cuda-<version>.exe (CUDA backend)
  • Windows, AMD/Intel GPUCapsuleers.IA-Setup-AMD_Vulkan-<version>.exe (Vulkan backend)
  • Linux, NVIDIA GPUCapsuleers.IA-NVIDIA_Cuda-<version>.AppImage (CUDA backend)
  • Linux, AMD/Intel GPUCapsuleers.IA-AMD_Vulkan-<version>.AppImage (Vulkan backend)

Pick the build that matches your graphics card: the NVIDIA_Cuda build runs NVIDIA cards on CUDA (fastest); the AMD_Vulkan build (lighter download) is for AMD/Intel GPUs and uses Vulkan. Both fall back gracefully if the preferred backend isn't available.

The installer is lite (code only). On first launch the app downloads, once, the embedding model + the EVE knowledge index and a chat model of your choice (you can change/add/remove models later). Updates are delivered automatically (electron-updater).

No macOS build yet (it needs Apple notarization). Building from source works on macOS.

What it does

  • Q&A on EVE — skills, fitting, ships/modules, missions, wormholes, sovereignty, anomalies, exploration, incursions, planetary interaction, factional warfare… with the sources it used.
  • Fit analysis — paste an EFT fit and get All-V validation (CPU/PG/slots/hardpoints/ drone bandwidth) plus DPS (weapon/drone/fighter split, alpha, sustained), weapon ranges, EHP + per-layer resistances, active/passive tank, cap stability, navigation (speed, mass, agility, align, warp) and targeting, and short theorycrafting on the role (PvP/PvE, strengths/weaknesses). The numbers are authoritative, offline and Pyfa-parity — computed by the bundled eve-fit-engine package (with its own version-pinned SDE), so nothing is sent to any server.
  • Live prices (EVE Ref) — "how much is a Caracal?", total cost of a material list.
  • Pilot intel (eve-kill killboard) — "who is <pilot/corp/alliance>?" → kills, losses, PvP stats; leadership and system activity via official ESI. When one name matches several entities (e.g. a character and a corporation), the app asks which one you mean before answering.
  • PvP analytics (eve-kill MCP) — relationships and fights from the killboard: "who flies with <pilot>", "who hunts <pilot>", "<X> vs <Y>", safe routes ("safe route from Jita to Amarr"), recent battles, the current meta/doctrines, most expensive kills, killmail story/forensics from a zKillboard link, plus entity overview/timeline/recent-kills, ships used, top rankings (favourite hulls/systems/regions, who they kill/die to) and global/system activity pulse.
  • Clipboard intel (Local + D-Scan) — with the Intel watcher on, copy a Local (Ctrl+A, Ctrl+C) and the app shows who's around it, flagging the dangerous ones; copy a directional scan and it recognises it too and gives an instant composition breakdown — ship classes, per-hull counts, detected system and other entities — classified fully offline from the bundled eve-fit-engine SDE. Either result can be shared: one click pushes it to capsuleers.app, copies a 24h link to your clipboard and keeps it in a local history with an expiry countdown.
  • Thera/Turnur wormhole connections (EVE-Scout) — "the Thera connection closest to Jita", with the entry and exit signatures and jump distance.
  • Model management — pick/download/delete chat models from an updatable catalog, filtered to a sensible VRAM range, with a response-time estimate for your GPU.
  • Self-updating knowledge base — daily jobs track every source (EVE patches/SDE, EVE University wiki edits, eve-survival missions, Anoikis wormhole data) and re-index only what changed; when a newer index is published the app downloads it in the background and offers a restart — no reinstall, no app update. If the data needs (re)downloading before the assistant can start, a dedicated data-update screen shows what's being fetched (in MB) and makes clear your AI model is already installed and won't be re-downloaded — distinct from the full first-run model picker.

Stack

Component Technology
App / UI Electron + HTML/JS
Inference (LLM + embeddings) node-llama-cpp — GPU Vulkan/Metal/CUDA, CPU fallback
Chat models Updatable catalog (Qwen3-4B, Qwen2.5-3B/7B, Mistral-Nemo 12B…), Q4 GGUF
Embeddings bge-m3 (Q8)
Index in-RAM vectors (cosine), no DB
Data factory Python (SDE parsing, wiki/mission scraping)

Two parts

  DATA FACTORY (build-time, Python)               APP (runtime, Electron + Node)
  ┌────────────────────────────────┐             ┌──────────────────────────────┐
  │ Official SDE (JSONL)            │             │  Chat UI (sci-fi, tray, mini) │
  │ EVE University Wiki (CC-BY-NC-SA)│   produces  │       engine.mjs              │
  │ eve-survival (missions)         │  ────────►  │  node-llama-cpp (GPU Vulkan/  │
  │  → parse/scrape → chunk → embed │  index +    │   Metal/CUDA) + in-RAM index  │
  │  → index.vec + meta + names     │  lookups    │  + eve-fit-engine (fit stats) │
  │                                 │             │  + live EVE APIs (intel/scout)│
  └────────────────────────────────┘             └──────────────────────────────┘
  • App (desktop/): Electron + node-llama-cpp. No server, no Qdrant/Ollama, no Python at runtime.
  • Data factory (ingestion/): a Python pipeline run offline (by whoever builds the app) to generate the knowledge base and keep it up to date via daily incremental jobs (SDE, MediaWiki wikis, eve-survival missions, Anoikis wormhole).

Data sources

  • Official SDE (JSON Lines) — skills, ships, modules, dogma, universe, industry, blueprints, sites/anomalies, lore. Authoritative source.
  • EVE University Wiki (CC BY-NC-SA 4.0, non-commercial) — mechanics, terminology, mining, exploration.
  • EVE Sister Core Scanner Probe Wiki (Fandom, DE — CC BY-SA) — exploration sites: anomalies, signatures, relic & data sites.
  • EVE Wiki (eve.fandom.com, EN — CC BY-SA) — general EVE encyclopedia.
  • eve-survival.org — PVE mission guides (license not explicitly stated: see the note in ingestion).
  • Riley Entertainment — combat-site ship fits, COSMOS guides, hacking/relic/data loot stats (no explicit licence → opt-in --riley, never part of --all).
  • Anoikis (wormhole effects/statics) · EVE Ref (live prices) · ESI (official live data) · eve-kill.com (killboard + MCP analytics) · EVE-Scout (Thera/Turnur connections).

Adding another MediaWiki = append a WikiSource to ingestion/.../wiki/sources.py; it is picked up by both the full crawl (--wiki) and the daily incremental timer automatically.

Build from source

cd desktop
npm install
npm start            # dev (expects models/ and data/ present locally)
npm run dist:linux:cuda   # or :vulkan — AppImage. On Windows: dist:win:cuda / :vulkan

Want to contribute? Start with CONTRIBUTING.md — step-by-step dev setup, every internal command, and the conventions. Other guides: desktop/README.md, release process in RELEASING.md, knowledge base in ingestion/README.md.

Structure

  • desktop/ — the standalone app (Electron + GPU RAG engine + live-data features).
  • ingestion/ — Python data factory (SDE, wiki, missions, names index, auto-update).
  • docs/ — architecture notes and data sources.

License

  • Source code: MIT.
  • Knowledge base index (release artifact, not in the repo): effectively non-commercial because it also derives from CC BY-NC-SA 4.0 content (EVE University Wiki). See THIRD_PARTY.md.
  • GGUF models: downloaded at runtime, each under its own license (Apache-2.0 / MIT). They are not redistributed by this repo.

Full attributions and third-party notices: THIRD_PARTY.md.

Created by TremalJack with the support of the EVE Online community.

Disclaimer

EVE Online and the EVE logo are the registered trademarks of Fenris Creations. All rights reserved worldwide. All other trademarks are the property of their respective owners. All EVE Online related materials are the intellectual property of Fenris Creations. Fenris Creations does not endorse, and is in no way affiliated with, Capsuleers.IA, and is not responsible for the content or functioning of this software.

Capsuleers.IA is an unofficial, non-commercial fan-made project.

About

An expert AI assistant for EVE Online — a standalone desktop app, cross-platform, 100% local and GPU-accelerated. Ask about skills, fitting, terminology, PVE missions, wormholes, sovereignty, exploration, industry and more, and get answers with cited sources, in Italian or English (auto-detected). Powered by Capsuleers.app

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors