dsh-h-v1

🐋 FreeDSH

Run DeepSeek Harness with free and low-cost AI models — with automatic routing, fallback and safe updates.

FreeDSH is the community-facing name for this repository (dsh-h-v1). It adds a practical distribution layer on top of DeepSeek Harness: free-model routing, a local provider gateway, a friendlier UI, pt-BR support, versioned configuration and rollback-safe updates.

Unofficial project. FreeDSH is not affiliated with or endorsed by DeepSeek.

Português: README.pt-BR.md

---

Why FreeDSH?

DeepSeek Harness is powerful, but a daily setup can become expensive or fragile when you depend on a single model/provider. FreeDSH focuses on a different experience:

The idea in one diagram

flowchart LR
    U[You / DeepSeek Harness] --> R[FreeDSH Smart Router]
    R --> F[FreeLLMAPI]
    R --> O[OpenRouter :free]
    R --> C[OpenCode free / zen]
    R --> P[Optional paid fallback]
    F --> G[Groq / Cerebras / Mistral / others]

Free tiers change over time. FreeDSH does not bypass provider terms or create free access where none exists; it integrates and routes the providers/keys you configure.

---

Install in 1 minute

Windows

Open PowerShell and run:

powershell -ExecutionPolicy Bypass -Command "$f=\"$env:TEMP\dsh-setup.ps1\"; irm https://raw.githubusercontent.com/marcosmmjr2023/dsh-h-v1/main/installer/dsh-setup.ps1 -Headers @{'Cache-Control'='no-cache'} -OutFile $f; & $f"

The interactive installer detects an existing installation and can install, update, preserve local configuration, manage parallel instances or open the GUI.

After installation, open a new PowerShell:

dsh up          # open the GUI
dsh update      # update repo/core/overlay
dsh doctor      # diagnostics
dsh env list    # list parallel instances

Linux

Debian/Ubuntu-like systems:

bash <(curl -fsSL https://raw.githubusercontent.com/marcosmmjr2023/dsh-h-v1/main/installer/dsh-setup.sh)

For manual/server installation, see docs/SERVER-MAP.md.

Provider credentials stay local and must never be committed. See SECURITY.md before exposing any FreeLLMAPI/admin interface beyond localhost.

Already run DeepSeek Harness?

FreeDSH also ships as a DSH bundle, for people who already have a working harness and only want the plugins (Smart Router, OpenRouter groups, model visibility, FreeLLMAPI shortcut, right-hand panel, version badge). No installer, no overlay copying:

dsh plugin --profile web add github:marcosmmjr2023/dsh-h-v1

Remove it with dsh plugin --profile web remove freedsh. The bundle registers plugins only — it never touches your keys, providers or settings. Requirements, what is included, where the state lives and common issues: docs/INSTALL-BUNDLE.md.

---

What is inside?

• Smart Model Router — free-first, task-aware model selection and runtime fallback.
• FreeLLMAPI integration — a local gateway for multiple free/low-cost providers.
• UI overlay — status badges, shortcuts and model controls inside DeepSeek Harness.
• Safe core updater — parallel A/B-style core instances with live progress.
• Versioned overlay — settings, plugins and presets managed as code.
• Sync + rollback tools — local snapshots, git tags/history and restore tooling.
• pt-BR localization — experimental DeepSeek Harness localization and translated docs.

Technical overview: docs/ARCHITECTURE.md

---

Documentation

---

Help build FreeDSH

You do not need to be an expert in the whole project. Useful contributions include:

• test a free provider and report compatibility;
• add or improve a provider adapter;
• improve Windows/Linux installation;
• add translations;
• reproduce bugs;
• improve documentation;
• propose better routing rules or benchmarks.

Start with CONTRIBUTING.md, then look for issues tagged good first issue or help wanted.

Questions, ideas and "does this work with X?" belong in Discussions. Bugs and concrete proposals go to Issues — a minimal report (OS, PowerShell version, dsh doctor output) gets fixed much faster.

If you use FreeDSH and it helps you, a ⭐ on the repository helps other DeepSeek Harness users discover it.

---

Project principles

1. Free-first, not free-at-any-cost. Respect provider terms and use paid fallback when that is the reliable choice.
2. Never break a working environment silently. Snapshot before replacement and make rollback practical.
3. Credentials stay local. Secrets, sessions and runtime state do not belong in git.
4. Upstream first. FreeDSH extends DeepSeek Harness; it does not pretend to be the upstream project.
5. Community over private customization. Reusable improvements should become documented, reviewable contributions.

---

License and attribution

• Original FreeDSH overlay/tools/installer/docs: MIT — see LICENSE.
• What that MIT grant covers (and what is explicitly not ours): LICENSE-SCOPE.md.
• Third-party assets: see THIRD_PARTY_NOTICES.md.
• DeepSeek Harness is installed separately and is not redistributed as this project's core.

Security reports: SECURITY.md · Community standards: CODE_OF_CONDUCT.md