6 Metode untuk Men-deploy DeepSeek Harness Secara Lokal

TLDR DeepSeek Harness (dsh) adalah runtime agen open-source dari DeepSeek AI, dirilis dalam pratinjau pengembang sekitar 13 Agustus 2026 di bawah lisensi MIT. Ini mengikuti prinsip “Model + Harness = Agent,” dengan setiap kapabilitas (model, tools, sessions, sandboxes, loops, 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 akan memulai UI Web di http://127.0.0.1:3080. Anda menyediakan kunci API DeepSeek (atau kompatibel 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 OpenAI dari CometAPI.

Poin Penting

• DeepSeek Harness bukan model—ini adalah runtime/orchestrator lokal yang memungkinkan model bertindak pada file, shell, tools, dan sesi.
• One-liner resmi: npx @deepseek-ai/dsh web → membuka UI Web 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 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 lebih dari 100k bintang GitHub dalam hitungan hari sejak 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 diharapkan—sematkan versi untuk eksperimen mirip produksi.

Apa itu DeepSeek Harness dan Mengapa Penting pada 2026

DeepSeek Harness (dsh) adalah runtime agen open-source yang dikembangkan oleh DeepSeek AI. Dirilis di bawah lisensi MIT dalam pratinjau pengembang, ini menekankan komposabilitas: setiap kapabilitas—adapter model, tools, skills, sessions, sandboxes, storage, agent loops, scheduling, dan UI—ada sebagai plugin Cordis yang dapat dipasang, dicopot, ditukar, atau direkomposisi melalui konfigurasi. Praktis tidak ada inti istimewa yang perlu ditambal.

Prinsip desain utama mencakup:

• Agent = Model + Harness.
• Aliran event yang dapat ditelusuri mendukung resume, fork, pencarian, dan replay.
• Beragam mode runtime (toolset penuh standar, mode code/orchestration, mode minimal untuk benchmarking, mode creator/eksperimental).
• UI Web lokal untuk penggunaan interaktif serta opsi headless dan SDK untuk otomasi.

Sumber resmi:

• GitHub: https://github.com/deepseek-ai/deepseek-harness
• Produk/landing: https://www.deepseek.com/harness/en/ (dan versi bahasa Mandarin)
• Halaman panduan instalasi dan mirror komunitas menegaskan perintah inti yang sama.

Catatan terminologi penting: “deploy lokal” dapat berarti dua hal berbeda. DeepSeek Harness yang dibahas di panduan ini berjalan secara lokal di komputer Anda, tetapi proyek standar deepseek-harness terhubung ke DeepSeek V4-Pro atau V4-Flash melalui API. Itu berarti 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 deployment yang berbeda.

Prasyarat dan Persyaratan Sistem

Sebelum menginstal, verifikasi 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 UI Web utama. Rentang target adalah ^22.19.0 || ≥24.0.0. Periksa dengan node --version. Versi intermediate bernomor ganjil di luar rentang ini tidak didukung.
• Package manager: npm/npx (ikut dengan 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 apa pun yang kompatibel OpenAI.
• Perangkat keras: Tidak diperlukan GPU untuk harness itu sendiri—inferensi model terjadi secara remote (atau melalui penyedia lokal yang Anda konfigurasi). Sumber daya laptop biasa sudah cukup untuk UI Web dan orkestrasi.
• Jaringan: Diperlukan saat pertama kali menjalankan untuk mengambil paket; setelah itu UI dapat beroperasi hanya dengan panggilan API model.
• Workspace: Siapkan direktori terisolasi. Agen dapat membaca, menulis, dan menjalankan 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: One-Liner Resmi dengan npx (Direkomendasikan untuk Sebagian Besar Pengguna)

Ini adalah jalur tercepat dan dipromosikan secara resmi.

1. Pastikan Node.js memenuhi persyaratan versi.
2. Buka terminal dan jalankan:

Bash

npx @deepseek-ai/dsh web

1. Paket diunduh (atau memakai cache), memulai profil UI Web, dan mencetak alamat listening—secara default http://127.0.0.1:3080.
2. Buka URL tersebut di browser. Terima pemberitahuan pratinjau pengembang jika muncul.
3. Pada penggunaan pertama, konfigurasikan penyedia model (Settings → Models) dengan menempelkan kunci API Anda dan memilih model seperti deepseek-v4-flash atau deepseek-v4-pro.
4. Pilih atau buat direktori workspace.
5. Mulai menjalankan tugas.

Untuk menggunakan port berbeda:

Bash
npx @deepseek-ai/dsh web --port 8080

Platform-specific one-liners 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 publik terbaru; onboarding paling sederhana. Kekurangan: Bergantung pada jaringan untuk paket awal; kurang nyaman untuk inspeksi sumber mendalam atau build kustom.

Metode 2: Instal dan Jalankan dari Sumber

Gunakan ini saat Anda ingin membaca plugin Cordis, menyematkan 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

UI Web yang sama akan 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, menyimpan data secara lokal, dan mendaftarkan perintah dsh.
• Packaging berbasis Electron yang menyertakan dependensi yang dipatok.

Unduh installer dari halaman GitHub Releases masing-masing (cari “deepseek-harness-desktop”). Peluncuran pertama mengunduh komponen inti (beberapa ratus MB). Ini nyaman untuk non-developer namun bukan produk resmi DeepSeek—tinjau repositori dan checksum SHA.

Metode 4: Deployment Docker / Container

Image Docker dan file compose komunitas tersedia untuk menjalankan UI Web di dalam container, sering kali dengan terminasi HTTPS melalui nginx dan dukungan untuk gateway kompatibel 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

Berguna untuk akses LAN, server, atau lingkungan di mana Node tidak diinginkan pada 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 menyertakan 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

Pencarian web dan dukungan tool bergantung pada model yang dipilih dan akses cloud Ollama.

Mengonfigurasi Model dan Penyedia (Termasuk CometAPI)

Di dalam UI Web buka Settings → Models.

• Untuk resmi DeepSeek: 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 Provider permanen, base URL, protokol (biasanya openai-completions), referensi atau nilai kunci API, dan minimal 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 OpenAI: https://api.cometapi.com/v1.

Manfaat saat digunakan dengan DeepSeek Harness:

• Satu kunci API alih-alih mengelola banyak kredensial penyedia.
• Harga kompetitif (dilaporkan penghematan 20–40% dibanding tarif vendor langsung pada banyak model).
• Ketersediaan tinggi (target SLA 99,9%), latensi median rendah, dan penagihan pay-as-you-go.
• Pergantian model mudah untuk A/B testing atau optimasi biaya tanpa mengubah konfigurasi harness selain ID model.
• Kompatibilitas drop-in: pola SDK OpenAI yang ada bekerja setelah hanya mengubah base_url dan kunci.

Dalam formulir custom-provider di 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 dan hemat biaya. Pengguna baru biasanya menerima kredit uji coba gratis. Dokumentasi: https://apidoc.cometapi.com/.

Kunci disimpan write-only (mis. di $DSH_HOME/.credentials.yaml); UI hanya menampilkan deskriptor yang disamarkan.

Pemecahan Masalah DeepSeek Harness

DEEPSEEK_API_KEY tidak ditemukan

Periksa:

echo $DEEPSEEK_API_KEY

Di Windows:

echo $env:DEEPSEEK_API_KEY

Jika kosong, konfigurasikan lagi.

Galat 400 reasoning_content

Ini biasanya menunjuk ke penanganan siklus hidup penalaran yang tidak benar.

Periksa bahwa aplikasi Anda mempertahankan informasi penalaran asisten yang relevan di seluruh permintaan multi-giliran thinking/tool-call.

Ini adalah salah satu isu inti yang secara khusus dirancang untuk ditangani oleh harness.

Kesalahan 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 rusak saat streaming

Jangan berasumsi potongan stream tiba sesuai urutan tool.

Gabungkan delta tool-call berdasarkan tool_call.index, sebagaimana direkomendasikan oleh kontrak harness.

Permintaan tiba-tiba mahal

Periksa:

• mode penalaran (thinking mode)
• panjang keluaran
• tingkat cache-hit
• stabilitas awalan prompt
• pilihan model
• harga API saat ini

Peningkatan sederhana sering kali dengan memindahkan tugas rutin dari Pro ke Flash.

Perbandingan Metode Instalasi dan Deployment

Data disintesis dari dokumen resmi dan panduan pascapeluncuran (Agustus 2026).

Kesimpulan dan Langkah Selanjutnya

DeepSeek Harness menghadirkan runtime agen yang dirancang bersih dan sepenuhnya berbasis plugin ke mesin lokal dengan friksi nyaris nol melalui one-liner npx. Dikombinasikan dengan perutean model yang fleksibel—terutama melalui platform terpadu seperti CometAPI—Anda mendapatkan kekuatan alur kerja pengkodean agentik modern serta kontrol praktis atas biaya, pilihan model, dan lokalisasi 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 benchmarking, penyedia kustom untuk optimasi biaya, atau Python SDK untuk otomasi.

Untuk instruksi resmi terbaru selalu utamakan repositori GitHub dan dokumen. Untuk keandalan multi-model dan keunggulan harga saat menjalankan harness, jelajahi CometAPI dan dokumentasinya di https://apidoc.cometapi.com/.