Proksi Langganan — Gerbang Bersama

Bayangkan ini seperti keanggotaan gym: kamu nggak akan kasih kartu aslimu ke teman dan berisiko kehilangan. Sebaliknya, kamu kasih mereka guest pass. Subscription Proxy itu persis seperti guest pass untuk langganan AI-mu.

Masalah yang Dipecahkan

Banyak aplikasi AI — seperti OpenViking atau Open WebUI — menggunakan format API OpenAI. Kamu bisa kasih mereka kunci langganan Nous Portal-mu secara langsung, tapi itu berisiko (bisa bocor) dan menyebalkan (kunci punya masa berlaku). Proxy ini memperbaiki masalah tersebut dengan menjalankan server lokal kecil. Setiap permintaan dari aplikasimu melewati proxy ini, dan proxy secara otomatis melampirkan kredensial aslimu. Aplikasi-aplikasimu bisa pakai kunci palsu apa saja — proxy yang akan menukarnya dengan kunci asli di belakang layar.

Perbedaannya dengan API Server

	API Server	Subscription Proxy
Yang disediakan	Agen Hermes lengkap (tools, memori, keterampilan)	Inferensi model murni
Paling cocok untuk	“Pakai Hermes sebagai backend chat”	“Bagikan langganan Portal-mu ke aplikasi lain”
Autentikasi	Butuh API_SERVER_KEY-mu	Token bearer apa saja (proxy yang menggantinya)
Pemanggilan tools	Didukung	Tidak didukung (pass-through murni)

Dalam satu kalimat: Pakai API server saat kamu butuh agen; pakai proxy saat kamu hanya butuh modelnya.

Tiga Langkah untuk Memulai

1. Masuk Sekali

hermes portal

Browser akan terbuka menuju halaman otorisasi Nous Portal. Setelah kamu masuk, Hermes menyimpan refresh token di ~/.hermes/auth.json.

2. Jalankan Proxy

hermes proxy start

Kamu akan melihat output seperti ini:

Starting Hermes proxy for Nous Portal
  Listening on:  http://127.0.0.1:8645/v1
  Forwarding to: (resolved per-request from your subscription)
  Use any bearer token in the client — the proxy attaches your real credential.

Mau menjalankannya di latar belakang? Gunakan tmux, nohup, atau layanan systemd.

3. Konfigurasi Aplikasimu

Aplikasi apa pun yang kompatibel dengan OpenAI hanya butuh tiga pengaturan:

Base URL:   http://127.0.0.1:8645/v1
API key:    apa saja (mis. "sk-unused")
Model:      Hermes-4-70B    # atau Hermes-4.3-36B, Hermes-4-405B

Proxy mengabaikan kunci apa pun yang kamu ketik dan menggantinya dengan kredensial Portal aslimu — dan otomatis memperbaruinya sebelum masa berlakunya habis.

Cek Status

hermes proxy status

Kamu ingin melihat status ready. Jika muncul not logged in, jalankan hermes portal lagi. Jika muncul credentials need attention, refresh token-mu telah dicabut (biasanya karena kamu keluar di situs web Portal) — tinggal masuk lagi saja.

Endpoint yang Didukung

Proxy hanya meneruskan jalur yang benar-benar didukung oleh upstream; selain itu akan mengembalikan 404 dengan pesan yang jelas:

Jalur	Tujuan
/v1/chat/completions	Penyelesaian chat (mendukung streaming)
/v1/completions	Penyelesaian teks lama
/v1/embeddings	Vektor embedding
/v1/models	Daftar model yang tersedia

Ringkasan & Tips Praktis

Subscription proxy adalah adaptor yang aman: ia memungkinkan aplikasi lain berbagi langgananmu tanpa pernah mengekspos kunci aslimu, dan ia menangani masa berlaku untukmu. Saat ini ia mendukung Nous Portal dan xAI (Grok), dengan lebih banyak penyedia yang akan segera hadir.

Satu tips praktis: Jika kamu menggunakan banyak aplikasi, berikan masing-masing kunci palsu yang berbeda (misalnya sk-app1, sk-app2). Dengan begitu, log proxy menunjukkan dengan tepat aplikasi mana yang membuat permintaan mana — membuat proses debugging jauh lebih mudah. Selain itu, proxy secara default hanya mendengarkan di 127.0.0.1. Jangan ubah ke 0.0.0.0, atau perangkat lain di jaringanmu juga bisa memakai langgananmu.

---