dodoxandClaude Fable 5.1
7837ac6631
README keeps the one-paragraph pitch and name origin, adds example questions and a quick start. The tool index, usage examples, .env table and layout move to docs/usage.md (now also lists sell tiers, parkcash, undervalued, ships, lmscan). CLAUDE.md layout line points at it. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
46 lines
2.5 KiB
Markdown
46 lines
2.5 KiB
Markdown
<h1 align="center">
|
||
<br>
|
||
<img src='./PuGa.png' width="250px">
|
||
<br><br>
|
||
<b>PuGa</b>
|
||
<br><br>
|
||
</h1>
|
||
|
||
A recursively self-improving harness for Claude and humans for the game [Prosperous Universe](https://prosperousuniverse.com). You ask questions in plain language; Claude answers by running the tools in this repo against live market data and your own company data, instead of guessing - and when it catches itself doing the same ad-hoc work by hand more than once, it builds a tool for it instead, so the harness keeps getting sharper the more it's used.
|
||
|
||
```
|
||
what should I build next?
|
||
is a second smelter still worth it, or is the AL market full?
|
||
simulate adding a CHP to Deimos before I spend anything
|
||
how long until Nike runs out of RAT?
|
||
where do I post 40 BHP so it actually clears today?
|
||
```
|
||
|
||
Name origin:
|
||
Plutonium–gallium alloy (Pu–Ga) is a specialized metallic blend of plutonium and gallium primarily used to stabilize the desirable delta (δ) phase of plutonium at room temperature.
|
||
|
||
## What it can do
|
||
|
||
- **Find what to build.** Every recipe, but with market depth: how many buildings the market absorbs, what you'd really get for the output, and whether the margin has held for months or is a spike.
|
||
- **Simulate before you spend.** A replica of the PRUNplanner simulator, verified against the real thing. Marginal payback of one more building, and a warning if it overloads your housing.
|
||
- **Watch your position.** Cash, permits, buildings, storage and ships synced from FIO. Runway per material, cash-aware shopping lists, multi-base chains with real freight.
|
||
- **Trade.** Where to post an ask, how to split it, how long it takes to clear, where idle cash can sit meanwhile.
|
||
- **Talk to PRUNplanner.** Reads your plans, writes new ones, picks up edits you make in the web UI. Only touches plans it created.
|
||
|
||
Every number is an estimate from public and personal game data. Prices move; re-run before acting.
|
||
|
||
## Quick start
|
||
|
||
```sh
|
||
git clone <repo-url> PuGa && cd PuGa
|
||
python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"
|
||
cp .env.example .env # FIO and PRUNplanner keys, see docs/usage.md
|
||
claude # open Claude Code here and ask
|
||
```
|
||
|
||
Every tool is also a command: `puga scan`, `puga simulate plan.yaml`, `puga sell BHP 40`. Tool list, setup and layout: [`docs/usage.md`](docs/usage.md). Verified game mechanics and the market model: [`docs/`](docs/).
|
||
|
||
Your own empire (profile, state, plans, notes) lives in the gitignored `empire/` folder, so the repo stays public.
|
||
|
||
Not affiliated with Prosperous Universe, FIO or PRUNplanner.
|