🚀 deepseek2API - Self-Hosted DeepSeek API Gateway

Gateway AI mandiri berkinerja tinggi (High-Performance Self-Hosted Gateway) yang mengonversi layanan resmi DeepSeek AI menjadi API standar yang kompatibel penuh dengan OpenAI API.

Dilengkapi dengan daemon Proof-of-Work (PoW) Solver berbasis WebAssembly (Wasm SHA-3) berkecepatan tinggi, protokol resmi Android APK DeepSeek, dukungan penuh Deep Reasoning (R1 / deepseek-reasoner), Function / Tool Calling, Auto File & Image Upload, serta WebUI modern berbahasa Indonesia yang ringan dan siap dijalankan di Android Termux maupun Server VPS Linux.

---

🌟 Fitur Utama

• ⚡ Wasm SHA-3 Proof-of-Work (PoW) Solver: Daemon Node.js lokal terintegrasi yang menghitung tantangan DeepSeekHashV1 secara instan untuk setiap request chat completion maupun upload file.
• 🧠 Dukungan Penuh DeepSeek-R1 (deepseek-reasoner): Memisahkan secara bersih fase pemikiran (thinking process) ke dalam format standar delta.reasoning_content (streaming) dan message.reasoning_content (non-streaming).
• 🛠️ AI Agent & Tool Calling Support (100% Works): Kompatibel penuh dengan spesifikasi Function Calling OpenAI (tools & tool_calls). Teruji sukses untuk autonomous agent seperti Cline, Roo Code, Cursor, Dify, dan LangChain.
• 📎 Auto-Detect & Upload File Lokal: Cukup sebutkan path file atau gambar lokal di prompt Anda, gateway akan otomatis mengunggahnya ke server DeepSeek dan menyertakannya ke sesi percakapan (ref_file_ids).
• 🔑 Login Otomatis Email & Kata Sandi: Endpoint /api/v0/users/login otomatis untuk autentikasi dan pembaruan bearer token.
• 📊 Request Activity Logs Real-Time: Pantau histori pemanggilan API, model yang digunakan, prompt, response, durasi (ms), dan status kode secara live via WebUI (/admin/logs) maupun endpoint API (/api/admin/logs).
• 🎨 WebUI Dashboard Modern: Dashboard berbasis React 19 + Tailwind CSS + Lucide Icons yang bersih, responsif, dan 100% berbahasa Indonesia untuk mengelola akun, API key, konfigurasi runtime, dan playground uji coba.
• 📱 Termux & VPS Native: Backend Go super ringan dipadukan dengan daemon PoW efisien.

---

🏗️ Model yang Didukung

Model ID	Base Model	Keterangan
deepseek-chat	DeepSeek-V3	Model percakapan umum cepat dan cerdas
deepseek-reasoner	DeepSeek-R1	Penalaran mendalam dengan reasoning_content
deepseek-v3	DeepSeek-V3	Alias untuk deepseek-chat
deepseek-r1	DeepSeek-R1	Alias untuk deepseek-reasoner
deepseek-vision	DeepSeek Vision	Pemrosesan dokumen & gambar (Multi-modal)

---

⚡ Panduan Instalasi Cepat

1. Instalasi di HP Android (Termux)

# Update paket Termux dan instal dependensi
pkg update -y && pkg install git golang nodejs-lts -y

# Clone repositori
git clone https://github.com/Cxslin/deepseek2API.git
cd deepseek2API

# Jalankan build frontend dan backend
cd frontend && npm install && npm run build && cd ..
cd backend && go build -trimpath -ldflags="-s -w" -o ../bin/deepseek2api-backend . && cd ..

# Berikan izin eksekusi pada skrip manajemen
chmod +x start.sh stop.sh update.sh

2. Jalankan Layanan

# Menjalankan di background (Daemon: Go Backend + Node PoW Solver)
./start.sh -d

# Memeriksa status log
tail -f logs/output.log

# Menghentikan layanan
./stop.sh

Akses Web Dashboard melalui browser di: http://localhost:7861 (atau http://IP_HP_ANDA:7861).

3. Cara Update ke Versi Terbaru 🔄

Gunakan skrip pembaruan otomatis:

./update.sh

Skrip ini akan otomatis menghentikan server lama, menarik commit terbaru dari GitHub, mengompilasi ulang frontend & backend, lalu menyalakan kembali layanan.

---

🔑 Konfigurasi & Login Akun

1. Buka WebUI di browser: http://localhost:7861.
2. Masukkan Admin Key default: admin123456 (dapat diubah di menu Pengaturan Sistem).
3. Buka tab Manajemen Akun:
   • Masukkan Email dan Kata Sandi akun DeepSeek Anda, lalu klik Simpan / Login Akun.
4. Buka tab API Key untuk membuat key akses baru yang akan digunakan pada aplikasi atau klien OpenAI Anda.

---

🤖 Contoh Penggunaan

1. cURL Chat Streaming (deepseek-chat)

curl -s -N http://127.0.0.1:7861/v1/chat/completions \
  -H "Authorization: Bearer admin123456" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role": "user", "content": "Halo DeepSeek!"}],
    "stream": true
  }'

2. cURL Reasoning R1 Streaming (deepseek-reasoner)

curl -s -N http://127.0.0.1:7861/v1/chat/completions \
  -H "Authorization: Bearer admin123456" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-reasoner",
    "messages": [{"role": "user", "content": "1+1=?"}],
    "stream": true
  }'

3. Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    base_url="http://127.0.0.1:7861/v1",
    api_key="admin123456"
)

response = client.chat.completions.create(
    model="deepseek-reasoner",
    messages=[{"role": "user", "content": "Sebutkan 3 tips produktivitas."}]
)

print("Reasoning:", getattr(response.choices[0].message, "reasoning_content", None))
print("Jawaban:", response.choices[0].message.content)

---

⚙️ Variabel Lingkungan (.env)

Variabel	Default	Deskripsi
PORT	7861	Port listen server gateway
ADMIN_KEY	admin123456	Kunci master otorisasi WebUI & API
MAX_RETRIES	3	Jumlah percobaan ulang saat kegagalan upstream
UPSTREAM_STREAM_IDLE_TIMEOUT_SECONDS	180	Batas waktu idle streaming (detik)

---

🙏 Ucapan Terima Kasih & Sumber Referensi

Proyek ini dibangun berdasarkan riset dan fondasi dari:

• 📱 ZennzXD / deepseek-js oleh ZennzXD — Reverse engineering Android APK DeepSeek (deepseek-js), implementasi PoW challenge solver flow (Wasm SHA-3), autentikasi, dan endpoint API DeepSeek.
• 🌟 YuJunZhiXue/qwen2API — Fondasi arsitektur Go backend gateway dan compatibility layer format OpenAI.

---

📄 Lisensi

Proyek ini didistribusikan di bawah lisensi GNU General Public License v3.0 (GPL-3.0).