Cara Aktifkan Headroom AI di 9Router: Kompres Token sampai 95 Persen

Apa Itu Headroom AI

Headroom AI adalah context compression layer buat AI agents. Lo pasang di 9Router, semua prompt otomatis dikompres sebelum dikirim ke LLM. Hasilnya? Token usage turun 60 sampai 95 persen, tapi jawaban tetap akurat.

Lo pernah gak sih lagi asik coding pakai AI, terus liat token usage naik gila-gilaan? Belum lagi kalau context panjang, tool outputs gede, atau RAG chunks yang bikin prompt lo membengkak. Headroom solves that problem.

Headroom adalah tool open source dari Headroom Labs yang compress everything yang AI agent lo baca. Tool outputs, logs, RAG chunks, files, conversation history. Semua dikompres sebelum sampai LLM.

Yang bikin Headroom menarik ada beberapa hal. Pertama, dia support 6 algoritma kompresi: SmartCrusher buat JSON, CodeCompressor buat kode pakai AST, Kompress-base buat teks, dan algoritma lainnya. Kedua, dia jalan lokal, jadi data lo gak kemana-mana. Ketiga, dia punya fitur CCR (CacheAligner + Content Router) yang bikin kompresi lebih stabil dan reversible.

Kenapa Headroom Penting buat 9Router

9Router udah punya Caveman buat kompres output, tapi Headroom handle sisi input. Lo pakai keduanya, token savings-nya jadi double. Headroom compress prompt masuk, Caveman compress output keluar. Hasilnya? Hemat total bisa mencapai 90 persen lebih.

Cara Install Headroom di Linux

Karena 9Router biasanya jalan di VPS atau Linux VM, lo butuh install Headroom di environment yang sama. Berikut langkah-langkahnya.

Langkah 1. Siapkan Python venv

Pastikan Python 3 udah terinstall. Kalau belum, install dulu.

sudo apt install -y python3-full

Buat virtual environment baru.

python3 -m venv headroom-env

Aktifkan environment-nya.

source headroom-env/bin/activate

Langkah 2. Install Headroom

Setelah venv aktif, install Headroom beserta dependencies proxy-nya.

pip install "headroom-ai[proxy]"

Tunggu sampai selesai. Kalau gak ada error, Headroom udah terinstall.

Langkah 3. Jalankan Proxy Manual

Buka terminal baru, activate venv dulu, lalu jalankan proxy.

source headroom-env/bin/activate
headroom proxy --port 8787

Biarkan terminal ini tetap terbuka. Terminal ini berfungsi sebagai mesin proxy yang sedang berjalan di port 8787.

Kenapa Harus Manual?

Web interface 9Router gak bisa start proxy secara otomatis kalau ada kendala permission di OS. Dengan menjalankan langsung via terminal, lo memotong kendala UI tersebut.

Setelah proxy jalan, buka kembali web interface 9Router. Masuk ke menu Token Saver. Status Headroom harusnya berubah menjadi running dan ada info Headroom proxy is reachable. You can enable the token saver.

Aktifkan Token Saver

Setelah proxy running, toggle switch Headroom di menu Token Saver. Sekarang semua prompt yang dikirim lewat 9Router otomatis dikompres oleh Headroom sebelum sampai LLM.

Jadikan Systemd Service (Opsional)

Kalau lo gak mau repot buka terminal tiap kali server restart, jadikan Headroom sebagai system service supaya auto-start.

Langkah 1. Cari path executable Headroom

which headroom

Catat hasilnya. Biasanya jalurnya /home/USERNAME/.local/bin/headroom atau kalau pakai venv, di dalam venv folder.

Langkah 2. Buat file service systemd

sudo nano /etc/systemd/system/headroom-proxy.service

Paste konfigurasi ini.

[Unit]
Description=Headroom AI Proxy Service
After=network.target

[Service]
Type=simple
User=USERNAME
ExecStart=/absolute/path/to/headroom proxy --port 8787
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

Ubah User=USERNAME jadi nama user Linux lo. Ubah ExecStart dengan path yang lo catat tadi. Simpan file, lalu jalankan perintah berikut.

sudo systemctl daemon-reload
sudo systemctl enable headroom-proxy.service
sudo systemctl start headroom-proxy.service

Langkah 3. Cek status service

sudo systemctl status headroom-proxy.service

Kalau statusnya active (running), service udah jalan. Lo bisa close terminal yang tadi.

Troubleshooting

Kalau tombol Start di web interface masih gak muncul atau gak merespons, kemungkinan besar proxy belum jalan di background. Pastikan lo udah jalankan headroom proxy --port 8787 di terminal terpisah.

Kalau pakai venv, pastikan venv-nya di-activate dulu sebelum jalanin perintah proxy.

Kalau mau cek apakah proxy bisa diakses, curl localhost:8787 dari terminal. Harusnya ada response.

Penutup

Headroom AI bikin 9Router makin powerful. Lo gak perlu khawatir token usage membengkak lagi, karena semua prompt udah otomatis dikompres sebelum sampai LLM. Yang lebih penting, kompresinya reversible, jadi akurasi tetap terjaga.

Langsung aja install sekarang dan rasain bedanya.