explaingit

paritok-official/paritok-4b-v1

Analysis updated 2026-08-13

1,142PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A proxy that sits between AI coding agents and the LLM API, compressing requests to cut token costs by 25 to over 85 percent without losing information.

Mindmap

mindmap
  root((Paritok))
    What it does
      Compresses agent requests
      Filters tool schemas
      Summarizes history
    Tech stack
      Python
      Qwen3-4B
    Use cases
      Cut token costs
      Longer sessions
      Recover originals
    Audience
      Coding agent users
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Cut AI API token costs for coding agents like Claude Code, Cursor, or Codex.

USE CASE 2

Fit more turns into a long agent session without hitting the context window limit.

USE CASE 3

Reduce repeated tool-schema overhead sent on every agent request.

USE CASE 4

Recover the exact original file or tool output when the agent needs full detail.

What is it built with?

PythonQwen3-4B

How does it compare?

paritok-official/paritok-4b-v1openmoss/moss-transcribe-diarizejordan-gibbs/hyperresearch
Stars1,1421,1391,133
LanguagePythonPythonPython
Setup difficultymoderatehardeasy
Complexity3/54/53/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Point your existing agent's BASE_URL at the Paritok gateway, no code changes needed.

Use, modify, and distribute freely, including for commercial purposes, with patent protections and a requirement to keep license notices.

In plain English

Paritok is a middle layer that sits between an AI coding agent, such as Claude Code, Cursor, or Codex, and the AI model it talks to. Instead of changing anything about how you use your coding agent, you point it at Paritok instead of pointing it directly at the AI provider, and Paritok quietly shrinks the amount of text sent on every request before passing it along. The tool works through three separate techniques. First, it filters the list of tools an agent has access to. Coding agents often expose dozens of available tools in full detail on every single request, even though only a few are relevant to the current task, so Paritok keeps just the relevant ones in full detail and shrinks the rest, which can be recovered later if actually needed. Second, it compresses file contents and tool results, shrinking them to roughly a quarter of their original size while trying to preserve important details like function names, file paths, and error messages. Third, once a conversation grows long enough to fill up the model's available context, it summarizes older parts of the conversation so the session can keep going instead of running out of room. Importantly, none of this deletes information permanently. If the agent needs the exact original text it filtered or shrank, it can request it back on demand. The project reports that this approach can cut the amount of billed input text by roughly a quarter on the very first request, and by well over 80 percent in long running sessions where the same information would otherwise be resent over and over. The underlying compression is powered by a small, openly released 4 billion parameter AI model trained specifically for this task, built on the Qwen3-4B model and available on Hugging Face. The project is released under the Apache 2.0 license, which allows free use, modification, and commercial use. This tool is aimed at developers who use AI coding agents regularly and want to reduce their API costs and fit more conversation turns into a single session without switching tools.

Copy-paste prompts

Prompt 1
Help me point my Claude Code BASE_URL at the Paritok compression gateway.
Prompt 2
Explain how Paritok's tool-schema filter and content compression differ.
Prompt 3
Show me how to recover the original file contents Paritok compressed.
Prompt 4
Walk me through Paritok's pricing and how savings compound over a session.

Frequently asked questions

What is paritok-4b-v1?

A proxy that sits between AI coding agents and the LLM API, compressing requests to cut token costs by 25 to over 85 percent without losing information.

What language is paritok-4b-v1 written in?

Mainly Python. The stack also includes Python, Qwen3-4B.

What license does paritok-4b-v1 use?

Use, modify, and distribute freely, including for commercial purposes, with patent protections and a requirement to keep license notices.

How hard is paritok-4b-v1 to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is paritok-4b-v1 for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.