The day
On the platform, the build end, the fifteen minutes of grace and the freeze are the schedule the organizers
set; the Home page counts down to them on the server’s clock
(The clock, the grace and the freeze).
What a team gets
- A private repository of your own, created by the organizers from the event’s starter, with each member’s GitHub account invited. Your team keeps it after the day.
- The starter, a working tool with hands, ears and a voice, described below.
- Access to the two sponsored services for the day: H Company’s computer-use agents and Gradium’s voice API. The site says what each partner gives and when it reaches you: the Gradium code once your seat is confirmed, H’s docs and walkthrough the night before.
- The coaches, on the Chats page and in the room.
The starter: hands, ears and voice
The starter is a working tool you build on: a dashboard, a command-line client (starter) and an MCP
endpoint an agent connects to, over one API. It comes wired to two services:
- Gradium, the voice: it speaks a text as a wav file, and it turns a recording back into text.
- H, an agent in a cloud browser: you say what to do on the web in plain words, it does it in a real browser you can watch live, and it answers in plain text.
How to start
-
Clone your team’s repository: say
/plugin:jointo Claude Code once the plugin below is installed, or do it with the hackathon command line, as on Your hackathon, step by step:npm i -g @antasphere/hackathon,hackathon login,hackathon connect, thenhackathon setup --no-start. The clone lands in~/Antasphere/hackathon/<your-team>, with the agent files installed and the app not started yet: the starter needs its environment file first. -
Write
.envat the root of the clone: a database password, and your two keys,GRADIUM_API_KEY(a key from the Gradium console, gradium.ai) andHAI_API_KEY(a key from H’s platform, platform.hcompany.ai). A key you do not have yet can stay empty; add it later and restart the app. -
Start the app:
hackathon setupagain. It keeps the clone, builds the image, starts the app onhttp://localhost:3000and waits until it answers.hackathon doctorchecks it all without changing anything. -
Claim your instance. On the first boot the dashboard asks for the owner account and the setup
token, which the server writes to its log. The setup runs the app under the compose project
hackathon-<your-team>, so read the token withdocker compose -p hackathon-<your-team> logs app | grep 'claim the instance'from the clone. - Try it. Sign in, open Try it in the menu: the two integrations with their state, a text to speak, a microphone to transcribe, and an instruction to run in a browser, with its live view and its answer.
starter as a shell
function:
http://localhost:3000/mcp and finds the same verbs as tools: starter_voice_speak,
starter_voice_transcribe, starter_run_start, starter_run_get and starter_list_runs.
The hackathon plugin
The participant skills are not in the repository: they are the hackathon’s Claude Code plugin. Install it once, in Claude Code:/plugin:joindoes the start above with you: the command line, the sign-in, your GitHub username and invitation, the clone, the.envfile (it fills the database password and leaves your two keys for you to paste), then the start and the app opened./plugin:checkrunshackathon doctorand walks you through each failed check, restarts the app when it is down, then readshackathon event status: the phase, the deadlines and the freeze./plugin:demomakes your demo deck: it plays your running app with Playwright, takes one screenshot per step, builds the deck from them (one slide per step, so the jury can follow alone in five minutes, ending with what is not finished yet), hosts it on Slideless and hands its link to the platform withhackathon decks link.
add-resource skill of the starter walks a new resource through every layer of the tool, from the
table to the dashboard page, the way the placeholder was added. Rename the tool when it becomes yours:
pnpm instantiate <slug> --name "<Name>".
What the starter also carries
The starter is an Antasphere tool like the platform itself: members and workspaces, API keys, an audit log, files, a versioned HTTP API with its OpenAPI document, a dashboard in English and French, background jobs, and the MCP endpoint. The placeholder resource,items, goes through every one of those layers and is the
example to follow, then replace, with your own.
At the end of the day
Push before the freeze, and check on the Home page that the platform received your last revision. Hand in your two Slideless links withhackathon decks link, or say /plugin:demo to your agent for the demo deck. The jury opens the
demo decks after the event, so never share a link with a password or an expiry before Friday evening. The
third link, the vote presentation the other participants rank on the Vote page, goes in with
hackathon decks link --vote, or say /plugin:vote to your agent.