Getting Started

This hackathon runs on Paritok's hosted GPU server — free for all hackers, faster than a laptop GPU, and it tracks your token and cost savings on a live dashboard. No local model download needed.

Paritok runs as a proxy between your agent and the LLM API: it compresses each request's context, forwards it upstream, and your agent doesn't change — it just points at Paritok.

1. Install:

   pip install "paritok[proxy]"

2. Get your API key: sign up on the Paritok website and create an API key from your dashboard.

3. Initialize: run paritok init in your project directory to generate a paritok.yaml. Note: whatever directory you run init in is the directory you run Paritok from afterward — it reads the paritok.yaml in your current working directory.

4. Configure the GPU server: open paritok.yaml, set use_gpu_server: true, and paste in your API key.

5. Start the proxy — from the same directory as your paritok.yaml:

   paritok proxy --port 8080 --config-file paritok.yaml

Keep this terminal open — the proxy has to stay running for the whole session. Run your agent from a separate terminal.

6. Point your agent at it — set the base URL in the shell that launches your agent, then start the agent:

   # macOS / Linux
   export ANTHROPIC_BASE_URL=http://127.0.0.1:8080   # Claude Code
   export OPENAI_BASE_URL=http://127.0.0.1:8080      # Cursor / OpenAI-SDK agents
   # Windows PowerShell
   $env:ANTHROPIC_BASE_URL = "http://127.0.0.1:8080"
   $env:OPENAI_BASE_URL    = "http://127.0.0.1:8080"

Check it's working (optional): curl http://127.0.0.1:8080/stats shows live compression totals, and your savings also appear in real time on your dashboard.

Full details — SDK mode, API key setup, per-model pricing — are in the README. Hitting a snag while configuring or running Paritok? Ask in the Discord — the team is on hand throughout the hackathon for setup, integration, and debugging help, and it's where to report bugs.

Models & Code

Attribution

Crediting Paritok with a link in your README is required. A simple line works:

Built with [Paritok](https://github.com/Paritok-official/paritok-4b-v1).

Or, optionally, use a badge:

[![Built with Paritok](https://img.shields.io/badge/Built%20with-Paritok-1f2d3d)](https://github.com/Paritok-official/paritok-4b-v1)

Support & Community

  • Discord — technical support, integration help, and other builders
  • Contact: paritok9@gmail.com

Submission Help

  • Full rules & judging criteria: see the Rules tab and Judging Criteria