Skip to content

Latest commit

 

History

512 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tokenless

Web Harness

Put your existing web LLM accounts to work for your agents.

Quick start · What is Web Harness? · Providers · Capabilities · English · 简体中文

Tokenless API Dashboard showing usage trends, job outcomes, and capability demand by provider

Local Dashboard captured on 2026-09-06. Values are local job records and output-token estimates, not benchmarks or billing savings.

Three ways to use Tokenless

1. Tokenless Harness + API · Main workflow

Give Tokenless Harness a task; it manages execution through Tokenless API and returns the result.

Bring a task → Tokenless Web Harness runs the web workflow → results return to your agent or app; follow activity in Dashboard

2. Your own Harness + Tokenless API

Keep your Harness’s agent loop, tools, and sessions; connect its model interface to Tokenless API.

Choose your own Harness → connect Tokenless API to your web LLM accounts → replies return to your Harness

API setup and compatibility limits · Harness integration

3. Your own Harness + Tokenless skill

Add the Tokenless skill to your Harness; invoke it for selected tasks and bring the results back into your usual workflow.

Keep your workflow → call the Tokenless skill on demand for a selected task → continue in your own Harness

tokenless setup installs the skill into supported local agent skill directories. Setup · Skill instructions

AI-generated use-case illustrations. Available capabilities depend on the selected provider’s verified support.

Providers · 43 catalog entries

15 browser providers, plus 28 additional Direct-only providers. Listed from the current registry; available capabilities depend on verification.

Browser mode

ChatGPT
ChatGPT

Supported
Claude
Claude

Supported
Gemini
Gemini

Supported
Grok
Grok

Supported
Qwen / 千问
Qwen / 千问

Experimental
DeepSeek
DeepSeek

Experimental
Perplexity
Perplexity

Experimental
Z.ai / GLM
Z.ai / GLM

Experimental
Doubao / 豆包
Doubao / 豆包

Experimental
Kimi
Kimi

Experimental
Dola
Dola

Experimental
Arena
Arena

Supported
Meta AI
Meta AI

Experimental
Microsoft Copilot
Microsoft Copilot

Awaiting verification
GitHub Copilot
GitHub Copilot

Experimental

Microsoft Copilot is registered but has no verified browser capability route yet. The other browser entries comprise 5 supported and 9 experimental providers.

Direct mode: view all 40 mappings

G4F also maps these browser providers to Direct entry points: ChatGPT, Claude, Gemini, Grok, Qwen / 千问, DeepSeek, Perplexity, Z.ai / GLM, Arena, Meta AI, Microsoft Copilot, GitHub Copilot.

The following 28 additional entries are Direct-only. These are experimental mappings; catalog membership does not mean each has passed a real-provider run.

Provider ID Provider ID
Black Forest Labs black-forest-labs Blackbox AI blackbox
Cerebras cerebras Cloudflare AI cloudflare
Cohere cohere DeepInfra deepinfra
ElevenLabs elevenlabs Fenay AI fenay-ai
GLHF glhf Groq groq
Hugging Face hugging-face MiniMax minimax
NVIDIA nvidia Ollama ollama
OpenRouter openrouter Opera Aria opera-aria
Phind AI phind Pi pi
Pollinations pollinations Puter puter
Replicate replicate Sber GigaChat gigachat
Stability AI stability-ai Teach Anything teach-anything
TheB.AI theb-ai Together AI together
WhiteRabbitNeo whiterabbitneo YQCloud yqcloud

Direct setup and limits.

Check verified capabilities for each provider.

Start in three commands

Requires Node.js 22.13+. Apple Silicon macOS is the current target; Windows x64 is prerelease.

npm install --global tokenless@latest
tokenless setup
tokenless run --provider chatgpt --prompt "Review this proposal."

Setup opens the local dashboard. Reopen it anytime with tokenless dashboard.

Browser preparation and updates

Setup requires uv for the G4F runtime and synchronizes matching skills; upgrades sync them too. Use tokenless skills sync --json to refresh skills alone. The macOS menu app is a separate optional install and is not installed on Windows.

For native mode, use a current Chrome or Brave, enable remote debugging at chrome://inspect/#remote-debugging or brave://inspect/#remote-debugging, and approve the browser prompt. Setup also offers an Anti-Detect option.

Already installed? Run tokenless upgrade --check, then tokenless upgrade. See Updates for CLI and macOS app updates.

What is a Web Harness?

We call the layer that turns web LLMs into an agent’s working environment a Web Harness. Tokenless lets agents submit tasks through your existing web LLM accounts, use supported website capabilities, and bring results back into your workflow.

What you want to do What Tokenless handles
Put web LLMs to work for your agent Submit prompts, read responses, and continue supported conversations.
Work with your own material Use attachments, citations, and controls verified for the selected provider.
Connect an app and follow progress Run tasks through the CLI or local compatible APIs; view history and usage in Dashboard.

Web workflows need no separate provider API keys; sign-in stays in your selected browser. Tokenless API provides provider access; Tokenless Harness manages agent tasks and tool continuation.

Optional setup and integrations

Browser mode example: DeepSeek

Send tokenless/deepseek through the visible DeepSeek website using the local OpenAI-compatible interface, then return the response to the caller.

Watch the 7-second demo · Configure browser mode

Local Spark X2.5-4B router engine

On Apple Silicon, the Dashboard can use the official Spark MLX server for the local Spark X2.5-4B model. Ollama is not required; the V1 integration uses the fixed OpenAI-compatible endpoint below.

git clone https://github.com/XHToken/Spark-MLX-LLM.git
cd Spark-MLX-LLM
python3 -m venv .venv
.venv/bin/python -m pip install -e '.[test]'
.venv/bin/spark-mlx-server --model XHToken/Spark-X2.5-4B --host 127.0.0.1 --port 8080 --allowed-origins http://127.0.0.1:7331

In Dashboard → System → Semantic routing, select Spark X2.5-4B · local MLX and save. The health endpoint is http://127.0.0.1:8080/health; chat completions use http://127.0.0.1:8080/v1/chat/completions.

Codex integration

Install the optional Codex integration:

tokenless setup --install-codex

Restart Codex, open /hooks, and trust Tokenless.

The experimental Tokenless Harness Browser Extension supports user-approved observation and text input on one selected Chrome tab.

Go deeper

Tokenless is in early access: it reduces agent-side token use, but does not eliminate token use or bypass provider account requirements.

npm version npm monthly downloads

About

Handle agentic tasks by 10+ AI providers on web

Topics

Resources

Stars

14 stars

Watchers

1 watching

Forks

Releases

Contributors

Languages