TLDR DeepSeek Harness (dsh) adalah runtime agen sumber terbuka milik DeepSeek AI, dirilis dalam pratinjau pengembang sekitar 13 Agustus 2026 di bawah lisensi MIT. Ini mengikuti prinsip “Model + Harness = Agen,” dengan setiap kapabilitas (model, tool, sesi, sandbox, loop, UI) diimplementasikan sebagai plugin Cordis yang dapat ditukar.
Cara tercepat untuk menjalankannya secara lokal adalah npx @deepseek-ai/dsh web (memerlukan Node.js ^22.19 atau ≥24), yang memulai Web UI di http://127.0.0.1:3080. Anda memasukkan kunci API DeepSeek (atau yang kompatibel dengan OpenAI) dan sebuah workspace. Build dari sumber, aplikasi desktop, Docker, Python SDK, dan integrasi Ollama juga tersedia. Untuk akses multi-model tingkat produksi, keandalan, dan kontrol biaya saat menggunakan harness, rute permintaan melalui endpoint terpadu yang kompatibel dengan OpenAI milik CometAPI.
Poin Penting
- DeepSeek Harness bukan model—ini adalah runtime/orchestrator lokal yang membuat model dapat bertindak pada file, shell, tool, dan sesi.
- One-liner resmi:
npx @deepseek-ai/dsh web→ membuka Web UI lokal pada port 3080. - Persyaratan Node.js ketat: ^22.19.0 atau ≥24.x.
- Mendukung model resmi DeepSeek (deepseek-v4-flash, deepseek-v4-pro), gateway kustom yang kompatibel dengan OpenAI, dan model lokal via plugin/Ollama.
- Arsitektur sepenuhnya berbasis plugin (kernel Cordis); mode mencakup Standard, Minimal, Code, dan Creator.
- Adopsi cepat: puluhan ribu hingga jauh di atas 100k bintang GitHub dalam beberapa hari setelah peluncuran.
- Direkomendasikan untuk power user: pasangkan dengan CometAPI (https://www.cometapi.com/) sebagai penyedia kustom untuk akses ke 500+ model, penghematan biaya 20–40%, dan satu kunci API.
- Selalu gunakan workspace terisolasi; agen dapat memodifikasi file dan menjalankan perintah.
- Status pratinjau pengembang berarti perubahan breaking dapat terjadi—kunci versi untuk eksperimen mirip produksi.
Apa itu DeepSeek Harness dan Mengapa Penting pada 2026
DeepSeek Harness (dsh) adalah runtime agen sumber terbuka yang dikembangkan oleh DeepSeek AI. Dirilis di bawah lisensi MIT dalam pratinjau pengembang, ini menekankan komposabilitas: setiap kapabilitas—adapter model, tool, skill, sesi, sandbox, penyimpanan, loop agen, penjadwalan, dan UI—ada sebagai plugin Cordis yang dapat dipasang, dicopot, ditukar, atau dikomposisi ulang melalui konfigurasi. Praktis tidak ada inti yang diistimewakan yang memerlukan patching.
Prinsip desain utama meliputi:
- Agen = Model + Harness.
- Stream event yang dapat ditelusuri mendukung resume, fork, search, dan replay.
- Beberapa mode runtime (toolset lengkap standar, mode code/orchestration, mode minimal untuk benchmarking, mode creator/eksperimental).
- UI Web lokal-first untuk penggunaan interaktif plus opsi headless dan SDK untuk otomasi.
Sumber resmi:
- GitHub: https://github.com/deepseek-ai/deepseek-harness
- Produk/landing: https://www.deepseek.com/harness/en/ (serta versi Tionghoa)
- Halaman panduan instalasi dan mirror komunitas menegaskan perintah inti yang sama.
Catatan terminologi penting: “penyebaran lokal” bisa berarti dua hal berbeda. DeepSeek Harness yang dibahas dalam panduan ini berjalan secara lokal di komputer Anda, tetapi proyek
deepseek-harnessstandar terhubung ke DeepSeek V4-Pro atau V4-Flash melalui API. Artinya harness, konfigurasi, sesi, validasi, dan logika klien dapat lokal, sementara inferensi model biasanya dilakukan oleh API DeepSeek. Jika Anda memerlukan inferensi benar-benar offline dengan bobot model di GPU Anda sendiri, itu adalah arsitektur penyebaran yang berbeda.
Prasyarat dan Persyaratan Sistem
Sebelum menginstal, verifikasi hal berikut:
- Sistem operasi: Windows 10+, macOS 10.15+, Linux arus utama (x64 atau arm64). Python SDK memiliki batasan tambahan (Linux x64/arm64 atau macOS 14+ arm64).
- Node.js: Diperlukan untuk jalur Web UI utama. Rentang target adalah ^22.19.0 || ≥24.0.0. Periksa dengan node --version. Versi intermediate bernomor ganjil di luar rentang ini tidak didukung.
- Manajer paket: npm/npx (terpasang bersama Node). Build dari sumber memerlukan pnpm (instal via npm install -g pnpm).
- Git: Diperlukan untuk cloning sumber.
- Python (opsional): 3.10+ untuk Python SDK resmi.
- Kunci API / endpoint: Kunci API DeepSeek dari platform.deepseek.com, atau endpoint + kunci + nama model yang kompatibel dengan OpenAI.
- Perangkat keras: Tidak diperlukan GPU untuk harness itu sendiri—inferensi model terjadi secara remote (atau melalui penyedia lokal yang Anda konfigurasikan). Sumber daya laptop biasa cukup untuk Web UI dan orkestrasi.
- Jaringan: Diperlukan pada run pertama untuk mengambil paket; setelah itu UI dapat beroperasi hanya dengan panggilan API model.
- Workspace: Siapkan direktori terisolasi. Agen dapat membaca, menulis, dan mengeksekusi perintah di dalam workspace yang dikonfigurasi—jangan pernah mengarahkannya ke data produksi atau pribadi tanpa pengamanan.
Sumber persyaratan: README resmi dan beberapa panduan instalasi independen yang diterbitkan segera setelah peluncuran.
Metode 1: Satu-baris Resmi dengan npx (Direkomendasikan untuk Sebagian Besar Pengguna)
Ini adalah jalur tercepat dan dipromosikan secara resmi.
- Pastikan Node.js memenuhi persyaratan versi.
- Buka terminal dan jalankan:
Bash
npx @deepseek-ai/dsh web
- Paket akan diunduh (atau memakai cache), memulai profil Web UI, dan mencetak alamat listening—secara default http://127.0.0.1:3080.
- Buka URL tersebut di peramban. Terima pemberitahuan pratinjau pengembang jika muncul.
- Pada penggunaan pertama, konfigurasikan penyedia model (Settings → Models) dengan menempelkan kunci API Anda dan memilih model seperti deepseek-v4-flash atau deepseek-v4-pro.
- Pilih atau buat direktori workspace.
- Mulai menjalankan tugas.
Untuk menggunakan port berbeda:
Bash
npx @deepseek-ai/dsh web --port 8080
One-liner spesifik platform yang juga memastikan Node tersedia disediakan oleh situs komunitas (PowerShell di Windows dengan winget, Homebrew di macOS, NodeSource di Debian/Ubuntu, dll.).
Kelebihan: Jejak instalasi permanen nol selain cache npm; selalu menarik versi terbaru yang dirilis; onboarding paling sederhana. Kekurangan: Bergantung pada jaringan untuk paket awal; kurang nyaman untuk inspeksi sumber yang mendalam atau build kustom.
Metode 2: Instal dan Jalankan dari Sumber
Gunakan ini saat Anda ingin membaca plugin Cordis, mengunci commit, mengembangkan preset kustom, atau berkontribusi.
Bash
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
Web UI yang sama muncul pada port default. Build pratinjau pengembang dapat rusak antar-commit, jadi perlakukan ini sebagai jalur eksperimental.
Metode 3: Aplikasi Desktop (Tanpa Setup Node)
Pembungkus desktop komunitas dan pihak ketiga mengemas runtime sehingga pengguna tidak perlu memasang Node/pnpm sendiri:
- Klien berbasis Tauri yang ringan yang melakukan bootstrap runtime Node terbundel dan menyinkronkan harness upstream terbaru saat peluncuran. Mereka berjalan di 127.0.0.1:3080, menjaga data tetap lokal, dan mendaftarkan perintah dsh.
- Packaging berbasis Electron yang menyertakan dependensi yang dipin.
Unduh installer dari halaman GitHub Releases masing-masing (cari “deepseek-harness-desktop”). Peluncuran pertama mengunduh komponen inti (beberapa ratus MB). Ini nyaman bagi non-developer tetapi bukan produk resmi DeepSeek—tinjau repositori dan checksum SHA.
Metode 4: Deployment Docker / Container
Image Docker dan berkas compose komunitas tersedia untuk menjalankan Web UI di dalam container, sering kali dengan terminasi HTTPS via nginx dan dukungan untuk gateway yang kompatibel dengan OpenAI apa pun. Alur tipikal:
Bash
git clone <docker-repo>
cd <docker-repo>
cp .env.example .env # set API key / public host
docker compose up -d --build
Bermanfaat untuk akses LAN, server, atau lingkungan yang tidak menginginkan Node di host. Beberapa setup mendukung settings.yaml kustom untuk penyedia non-DeepSeek.
Metode 5: Python SDK untuk Penggunaan Terprogram / Headless
Untuk agen tanpa pengawasan atau integrasi ke pipeline Python:
Bash
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
python -m pip install deepseek-harness-sdk
Set variabel lingkungan:
Bash
export DEEPSEEK_API_KEY=sk-your-key-here
# optional: export DEEPSEEK_BASE_URL=http://127.0.0.1:8000/v1
# optional: export DSH_MODEL=deepseek-v4-flash
Lalu jalankan contoh yang sudah disertakan atau gunakan kelas DeepSeekHarness dalam kode Anda sendiri terhadap workspace dan direktori sesi terisolasi. SDK membundel runtime-nya sendiri dan tidak memerlukan Node.js sistem.
Metode 6: Integrasi Ollama
Ollama menyediakan peluncur praktis:
Bash
ollama launch dsh
# or with a specific model
ollama launch dsh --model deepseek-v4-flash:cloud
Ollama dapat memasang paket jika diperlukan dan menyimpan pengaturan peluncuran secara terpisah. Pencarian web dan dukungan tool bergantung pada model yang dipilih dan akses cloud Ollama.
Mengonfigurasi Model dan Penyedia (Termasuk CometAPI)
Di dalam Web UI, buka Settings → Models.
- Untuk DeepSeek resmi: tempel kunci dari platform.deepseek.com. Model umum adalah deepseek-v4-flash dan deepseek-v4-pro.
- Untuk penyedia katalog (Anthropic, OpenAI, dll.): gunakan alur “Add provider”.
- Untuk endpoint kustom / self-hosted / agregator: pilih “Add a custom provider.” Berikan ID Penyedia permanen, base URL, protokol (biasanya openai-completions), referensi variabel lingkungan kunci API atau nilainya, dan setidaknya satu ID model.
Rekomendasi CometAPI (sangat disarankan untuk banyak alur kerja mirip produksi) CometAPI adalah platform infrastruktur AI terpadu yang mengekspos 500+ model (termasuk varian DeepSeek, GPT, Claude, Gemini, Grok, dan banyak lainnya) melalui satu endpoint yang kompatibel dengan OpenAI: https://api.cometapi.com/v1.
Manfaat saat digunakan dengan DeepSeek Harness:
- Satu kunci API alih-alih mengelola kredensial banyak penyedia.
- Harga kompetitif (dilaporkan penghematan 20–40% dibanding tarif vendor langsung untuk banyak model).
- Ketersediaan tinggi (target SLA 99,9%), latensi median rendah, dan penagihan pay-as-you-go.
- Pergantian model yang mudah untuk A/B testing atau optimasi biaya tanpa mengubah konfigurasi harness selain ID model.
- Kompatibilitas drop-in: pola SDK OpenAI yang ada tetap bekerja setelah hanya mengubah base_url dan kunci.
Dalam formulir custom-provider pada harness:
- Base URL:
https://api.cometapi.com/v1 - Protocol: openai-completions (atau opsi setara yang didukung)
- API key: kunci CometAPI Anda
- Model ID: string model apa pun yang didukung dari katalog model CometAPI
Kombinasi ini mempertahankan runtime agen lokal yang kuat sekaligus memberikan akses model multi-vendor yang fleksibel, hemat biaya. Pengguna baru biasanya menerima kredit uji gratis. Dokumentasi: https://apidoc.cometapi.com/.
Kunci disimpan write-only (mis., di $DSH_HOME/.credentials.yaml); UI hanya menampilkan deskriptor yang disunting.
Pemecahan Masalah DeepSeek Harness
DEEPSEEK_API_KEY tidak ditemukan
Periksa:
echo $DEEPSEEK_API_KEY
Di Windows:
echo $env:DEEPSEEK_API_KEY
Jika kosong, konfigurasikan kembali.
Galat 400 reasoning_content
Ini biasanya menunjukkan penanganan siklus hidup reasoning yang tidak benar.
Periksa bahwa aplikasi Anda mempertahankan informasi reasoning asisten yang relevan di seluruh permintaan multi-giliran thinking/tool-call.
Ini adalah salah satu isu inti yang secara khusus ditangani oleh harness.
Galat panjang konteks
Periksa:
input tokens + max_tokens
Batas keras yang didokumentasikan adalah:
1,048,576 tokens
Kurangi konteks input atau ukuran completion yang diminta.
Panggilan tool menjadi malformat selama streaming
Jangan mengasumsikan potongan stream tiba sesuai urutan tool.
Agregasikan delta tool-call berdasarkan tool_call.index, seperti direkomendasikan oleh kontrak harness.
Permintaan ternyata mahal
Periksa:
- mode berpikir
- panjang keluaran
- tingkat cache-hit
- stabilitas awalan prompt
- pilihan model
- harga API saat ini
Perbaikan sederhana sering kali memindahkan tugas rutin dari Pro ke Flash.
Perbandingan Metode Instalasi dan Deployment
| Method | Ease of Use | Node Required | Best For | Persistence / Control | Typical Port / Access | Notes |
|---|---|---|---|---|---|---|
| npx one-liner | Highest | Yes | Quick trials, most users | Ephemeral (cache only) | 3080 (configurable) | Official recommended |
| Source (pnpm) | Medium | Yes | Development, plugins, pinning | Full source control | 3080 | Needs pnpm + build |
| Desktop (Tauri/Electron) | High | No (bundled) | Non-technical users | Local profiles & auto-update | 3080 (internal) | Community packages |
| Docker | Medium | No (container) | Servers, LAN, HTTPS | Container volumes | Custom / 443 | Community images |
| Python SDK | Medium | No (bundled) | Headless, automation, pipelines | Programmatic sessions | N/A (no UI by default) | Official SDK |
| Ollama launch | High | Optional | Local-model experiments | Ollama settings | 3080 | Integrates with Ollama |
Data disintesis dari dokumentasi resmi dan panduan pasca-peluncuran (Agustus 2026).
Kesimpulan dan Langkah Berikutnya
DeepSeek Harness menghadirkan runtime agen dengan desain bersih dan sepenuhnya berbasis plugin ke mesin lokal dengan hampir tanpa friksi melalui one-liner npx. Dikombinasikan dengan perutean model yang fleksibel—terutama melalui platform terpadu seperti CometAPI—Anda mendapatkan kekuatan alur kerja coding agentik modern serta kontrol praktis atas biaya, pilihan model, dan lokasi data.
Mulai hari ini dengan:
npx @deepseek-ai/dsh web
Konfigurasikan kunci DeepSeek atau CometAPI, arahkan ke workspace yang aman, dan jelajahi mode Standard. Lalu bereksperimenlah dengan mode Minimal untuk benchmark, penyedia kustom untuk optimasi biaya, atau Python SDK untuk otomasi.
Untuk instruksi resmi terbaru, selalu utamakan repositori GitHub dan doc. Untuk keandalan multi-model dan keunggulan harga saat menjalankan harness, jelajahi CometAPI dan dokumentasinya di https://apidoc.cometapi.com/.


