everydaycats commited on
Commit
77c9610
·
verified ·
1 Parent(s): c7f4749

Delete README.md

Browse files
Files changed (1) hide show
  1. README.md +0 -89
README.md DELETED
@@ -1,89 +0,0 @@
1
- # agent-fleet
2
-
3
- A minimal, runnable scaffold for the pipeline we designed:
4
-
5
- ```
6
- Scout (cheap, high volume) -> Generate (cheap) -> Score (mid, kill gate) -> Build spec (mid)
7
- ```
8
-
9
- Each stage is a small class (`src/core/Stage.js`) with its own model, prompt,
10
- and output parser. `Pipeline` (`src/core/Pipeline.js`) chains them and stops
11
- early if a stage returns `{ kill: true }` — this is what keeps a bad idea
12
- from burning money on the more expensive Score/Build steps.
13
-
14
- ## Setup
15
-
16
- ```bash
17
- cd agent-fleet
18
- npm install
19
- cp .env.example .env
20
- # edit .env: add your OPENROUTER_API_KEY, adjust MAX_SPEND_USD
21
- ```
22
-
23
- Get an OpenRouter key at https://openrouter.ai/keys — it gives you one API
24
- for Gemini Flash, Llama, Claude, GPT, etc, which is why everything routes
25
- through it here even though you mentioned wanting to call Gemini directly
26
- later (swap `src/providers/openrouter.js` for a Gemini-native client when
27
- you're ready to scale — same `callModel()` interface, just point it at
28
- Gemini's endpoint instead).
29
-
30
- ## Run it
31
-
32
- ```bash
33
- # Sanity check: run ONLY the scout stage, see real output + cost
34
- node index.js scout
35
-
36
- # Run the full 4-stage pipeline once, sequentially
37
- node index.js pipeline
38
-
39
- # Run multiple pipelines in parallel (worker_threads), one per seed idea
40
- node src/runFleet.js
41
- ```
42
-
43
- Every run prints running spend (`$X.XXXX`) after each stage so you can see
44
- exactly where your OpenRouter balance is going before you scale up.
45
-
46
- ## What this does NOT do yet
47
-
48
- This scaffold stops at producing a **build spec** (a structured JSON plan),
49
- not an actual game/app/video. That's intentional — build (generate the
50
- artifact) and publish (put it live) are separate concerns, and you don't
51
- want an LLM call auto-publishing to an app store or social account. Next
52
- steps, in order of leverage:
53
-
54
- 1. **Feed real signal into Scout.** Right now `seed.rawSignal` is hand-written
55
- in `index.js` / `src/runFleet.js`. Replace with a real scraper (App Store
56
- review pulls, Reddit/trend APIs, CrazyGames charts) so Scout is reacting
57
- to real demand, not your guesses.
58
- 2. **Wire BuildStage's spec into an actual codegen step.** For browser
59
- games/apps, the `build_steps` array is meant to be handed to a coding
60
- agent (e.g. Claude Code) to actually produce the artifact. For video,
61
- it's meant to be handed to a script-to-assets pipeline.
62
- 3. **Add a PublishStage with a manual approval gate.** Keep a human in the
63
- loop before anything goes to an app store or social account — those are
64
- account-level risks, not post-level ones.
65
- 4. **Swap cheap-model calls to Gemini directly** once volume actually
66
- justifies leaving OpenRouter's per-call overhead behind.
67
-
68
- ## Cost model
69
-
70
- `src/providers/openrouter.js` tracks a rough running spend estimate and
71
- throws before any call that would exceed `MAX_SPEND_USD` in your `.env`.
72
- The price table (`ROUGH_PRICE_PER_1K` in `src/config.js`) is a rough
73
- estimate, not live pricing — check OpenRouter's pricing page and update it
74
- if you're being strict about a small balance.
75
-
76
- ## File map
77
-
78
- ```
79
- src/
80
- config.js # model routing + spend limit, all env-driven
81
- providers/openrouter.js# API client + spend guard
82
- core/Stage.js # base class every stage extends
83
- core/Pipeline.js # chains stages, honors early "kill" signals
84
- prompts/ # the actual prompt engineering (scout/generate/score)
85
- stages/ # thin classes wiring prompts + models together
86
- worker.js # one pipeline run, for use inside a worker_thread
87
- runFleet.js # spawns N parallel pipeline threads
88
- index.js # single-thread entry point for testing
89
- ```