dsh-chatgpt-free

Zero-cost conversational AI model provider for DeepSeek Harness powered by free ChatGPT Web (GPT 5.6 Luna).

---

Overview

dsh-chatgpt-free turns your local browser session of ChatGPT into a seamless, $0.00 API-free conversational model provider directly inside DeepSeek Harness (DSH).

It connects via headless or visible Chrome browser automation to chatgpt.com, streaming real-time Markdown responses, code solutions, explanations, and reasoning back to your DSH chats without consuming API credits.

Why Pure Chat?

Small conversational web models (like GPT 5.6 Luna) excel at explanations, dialogue, Q&A, brainstorming, code snippet generation, and side-assistant tasks. By running in Pure Chat Mode, the bridge eliminates prompt overhead, tool hallucinations, and syntax errors of autonomous 7-tool execution loops, providing a fast, rock-solid, zero-cost LLM provider.

Key Features

• 100% Free ($0.00 Cost): Uses your existing free ChatGPT Web session. No OpenAI API keys or credit cards needed.
• Cordis Plugin-First Lifecycle: Seamlessly managed by DSH via ctx.effect. DeepSeek Harness starts the background sidecar automatically on launch and shuts it down on exit.
• Dynamic Model Auto-Detection: Automatically detects your ChatGPT tier:
  • Free Accounts: Defaults to chatgpt-web/luna (gpt-5-6-luna).
  • Plus / Team Accounts: Automatically detects and exposes available paid models (such as gpt-4o, o1).
• Full Streaming Markdown & Code Blocks: Delivers tokens in real time directly to the DSH Web UI or CLI.

---

Quick Start

1. Installation

Install @wlv-zedd/dsh-chatgpt-free in your DeepSeek Harness environment or profile:

pnpm add @wlv-zedd/dsh-chatgpt-free

2. One-Time Browser Sign-In

Authenticate your ChatGPT account once:

npx @wlv-zedd/dsh-chatgpt-free login

A dedicated Chrome window will open. Log into your OpenAI / ChatGPT account. Once the ChatGPT composer is visible, the browser session is safely and securely saved locally to ~/.dsh/storages/chatgpt-free/.

3. Enable in DeepSeek Harness

Add the provider to your ~/.dsh/settings.yaml:

providers:
  chatgpt-web:
    displayName: "ChatGPT Web (Free)"
    api: openai-responses
    baseURL: http://127.0.0.1:17841/v1
    headers:
      Authorization: "Bearer chatgpt-web-free"
    streamIdleTimeoutMs: 300000
    models:
      - id: chatgpt-web/luna
        name: "ChatGPT Web — Luna (Free)"
        contextWindow: 1050000
        maxTokens: 32768
        input:
          - text
          - image

agent-default-model:
  provider: chatgpt-web
  model: chatgpt-web/luna

And add the sidecar plugin to your profile's cordis.patch.yml (or cordis.yml):

- insert:
    - id: dsh-chatgpt-free
      name: '@wlv-zedd/dsh-chatgpt-free'

Now start DeepSeek Harness:

pnpm dsh web

DSH will automatically start the background sidecar process, connect to your authenticated ChatGPT session, and accept prompts!

---

Diagnostics & Health Check

Verify your setup at any time with the built-in diagnostic doctor:

npx @wlv-zedd/dsh-chatgpt-free doctor

Example healthy output:

✓ Configuration is valid (~/.dsh/storages/chatgpt-free/config.json)
✓ Chrome executable found: C:\Program Files\Google\Chrome\Application\chrome.exe
✓ ChatGPT login state has authenticated browser evidence
✓ Responses proxy is healthy on 127.0.0.1:17841
Doctor result: ready

---

Notes & Limitations

1. Unofficial Bridge: Operates via local Playwright browser automation on chatgpt.com. Not affiliated with or endorsed by OpenAI.
2. Single-Session Concurrency: Runs within a single browser tab. Sequential queries and normal DSH agent chats work seamlessly; avoid launching parallel multi-subagent swarms against the same tab simultaneously.
3. Pure Chat Only: This provider generates pure conversational responses, explanations, reasoning, and code blocks. It does not execute local filesystem, terminal, or autonomous tool loops.
4. Standard Free Tier Rate Limits: Subject to standard OpenAI free-tier hourly usage limits.

---

Support & Community Perks

• 💖 Sponsor directly: If you find this plugin helpful, consider sending a small tip via PayPal.
• 🎁 Get Free AI Credits: Sign up on AgentRouter using this link with your GitHub account to receive up to $200 in free API credits for your DeepSeek and LLM workflows.

---

License

MIT License © 2026 WLV-ZEDD. DeepSeek Harness is an open-source project by DeepSeek AI.