Larga — Cebu Ai Agent Cup

A student tournament in Cebu, plus the kit that runs it.

You already know APIs, HTTP, and deploying a service. Ai here is the same idea: you POST text in, you get text out. An agent is just your program calling that API (and maybe calling it again with the last answer). Larga is one CloudFlare Worker that lets you chain those calls from a phone, keeps score, and prints a resume companies can open.

Larga na = let’s go (Cebuano). Born in Cebu.

Live Cup: larga.openroyleal.com

---

If you have never used Ai

Word you know	What we mean
HTTP API	An Ai model is a hosted function: prompt in, completion out. Groq, Google, CloudFlare Workers Ai, OpenRouter are vendors.
API quota / prepaid credits	Tokens. When they run out you get 429. Free student keys die. Make three accounts.
Retry / failover	Drive tries the next vendor when one is busy or empty.
Username	Handle (you can rename). Your real id never changes.
Leaderboard	Board. Season 0 of the Cup.
Portfolio / CV	Tape. One JSON file: GitHub + what you actually ran.
Serverless function	A Worker. One npm run deploy = your copy of Larga.

You do not need to train a model. You call other people’s models with free keys. That is enough to enter the Cup.

---

Why it is called a Cup

Cup = tournament. Same as a football cup: a season, a table, later school and country brackets.

Season 0 (now)	Later
Pilot vs Pilot — you vs other students	Crew — school vs school
Live Board	Flag — country vs country
Enter by claiming a handle and running Grid	Dock / OJT berth for companies

How you are ranked (Season 0)

The Board sorts, in order:

1. Graphs — how many times you actually ran a chain on Grid
2. Failovers — how many times Drive had to hop (a mint died, you kept going)
3. Tokens out — how much Ai you actually used

Pets, nicknames, and skins do not change rank. The kettle is shared sponsor quota (same rules for everyone), not a boost for 1st place.

How to enter: open larga.openroyleal.com → Continue with GitHub or Google → Grid → run. Tape: /u/your-handle/tape.

Season dates / brackets: still being posted on ROADMAP.md. The table is already live. That is Season 0.

---

Need / skip

You want	You need	Skip
Free Student Ai tokens (step-by-step, use-it-or-lose-them)	RESOURCES.md · optional laptop /v1: docs/free-llm-api.md	Omarchy until you want the Cup
A Linux laptop built for this	Omarchy	Larga until you want the Cup
Enter the Cup / Board / Tape	Open the live URL on that phone	extra keys until Drive 429s
Android terminal	Termux from F-Droid	Play Store Termux
iPhone / iPad	Safari → Add to Home Screen → Grid	A Linux terminal. You do not need one.

---

The kit (what you are deploying)

Piece	In IT terms
Grid	A tiny workflow: nodes = prompts, Run = call Drive
Drive	Router: Workers Ai → Groq → OpenRouter → Gemini… hop on 429 / 5xx / empty. 401 does not burn the next key
Profile	Your Pilot page + Board row + Tape

Optional pixel pet (Petdex): moves on the Board only while Drive is actually running. Skin, not score.

---

Enter on this phone

iPhone included. Open https://larga.openroyleal.com/install — claim a handle on that screen, Add to Home Screen, Grid. No second device.

Give this to your agent

Copy TO-YOUR-AGENT.md (same block is on live /install).

---

Omarchy laptop (not a browser tab)

App launcher name Larga. Hotkey Super+L.

1. Install Omarchy
2. From this repo (writes the shared Cup URL; change ~/.config/larga/url only for your own Worker):

chmod +x omarchy/install-app.sh omarchy/larga-app
./omarchy/install-app.sh

---

Android

Termux, not Play Store: f-droid.org/packages/com.termux

pkg update && pkg upgrade
pkg install tmux git

---

Your own copy (1 CloudFlare deploy)

You can play on the shared Cup with no keys. Deploying means your Worker, your Board.

Only this. Repo root. npm run deploy. packages/ is source. Do not add larga.openroyleal.com to wrangler — that hostname is the shared Cup.

git clone https://github.com/OpenRoyleAl/Larga
cd Larga
npm install
npx wrangler login
npx wrangler d1 create larga
# paste database_id into wrangler.jsonc (repo root)
npx wrangler d1 migrations apply larga
npm run deploy

Free tokens: RESOURCES.md is the step-by-step guide — Step 0 = shared Cup with 0 keys (Workers Ai); Step 2 = wired hops via wrangler secret put only:

npx wrangler secret put GROQ_API_KEY
npx wrangler secret put OPENROUTER_API_KEY
npx wrangler secret put GEMINI_API_KEY

Quotas nap and reset — use them or lose them. Drive hops on 429/5xx/529/empty; 401 stops the hop so a dead key does not burn the next mint.

Safe: secrets stay on CloudFlare. Not safe: pasting a key into Grid, GitHub, Discord, a screenshot, or any file you git add. Leaked? Revoke and mint new.

Optional laptop router (not the Cup): docs/free-llm-api.md · upstream FreeLLMAPI. Catalogs (verify dates): Student-free-ai-packs.

GitHub has Copy on code blocks. Live /install and /resources have Copy too.

---

Manifesto · Blueprint · Roadmap · Changelog

Apache-2.0 · OpenRoyleAl · Born in Cebu