chanthecno v1.2.2

chanthecno

v1.2.2

Aplikasi desktop chat AI open-source — bawa API key sendiri, tanpa akun, tanpa perantara.

🚧 v1.2.2 — Awal pengembangan fitur Pro. Mulai versi ini, chanthecno merintis fitur Pro: VPS terkelola dari chanthecno untuk menyimpan/mem-backup API key user (bukan lagi cuma opsi self-host server/ sendiri). Ini masih tahap awal/beta — arsitektur default (100% lokal, bawa API key sendiri) tidak berubah dan tetap jadi mode utama. Lihat Fitur Pro (Beta) di bawah.

---

Apa ini

chanthecno adalah aplikasi desktop untuk chat dengan AI, di mana user bawa API key sendiri (Claude, Gemini, GPT, atau endpoint OpenAI-compatible seperti Groq). Request dikirim langsung dari perangkat user ke provider — tidak ada perantara, tidak ada sistem akun/login.

chanthecno/
├── dist/                   # Frontend (HTML/CSS/JS) — inilah yang tampil di jendela app
├── src-tauri/               # Shell desktop (Rust + Tauri)
├── server/                   # Backend VPS OPSIONAL — backup API key terenkripsi
└── .github/workflows/        # Build otomatis installer Windows & Linux

Daftar isi

• Fitur Pro (Beta)
• Kenapa arsitekturnya begini
• Provider yang didukung
• Menjalankan mode development
• Install lewat GitHub Release
• Build installer sendiri
• Deploy backend ke VPS
• Roadmap

Fitur Pro (Beta)

Mulai v1.2.2, chanthecno mulai merintis fitur Pro: alih-alih user harus deploy dan kelola server/ sendiri di VPS pribadi buat fitur backup, chanthecno akan menyediakan VPS terkelola langsung dari tim chanthecno.

Beberapa poin penting soal arah fitur ini (masih berkembang, bisa berubah):

• Status: tahap awal/beta. Belum jadi pengganti mode default — user yang tidak butuh backup tetap bisa pakai app 100% lokal seperti biasa, tanpa terhubung ke VPS mana pun.
• Tujuan: user yang mau fitur backup API key tidak perlu repot setup server, MASTER_KEY, atau reverse proxy sendiri — cukup aktifkan Pro dan chanthecno yang mengurus infrastrukturnya.
• Keamanan tetap prioritas: rencananya API key tetap dienkripsi (AES-256-GCM) sebelum disimpan, sama seperti skema self-host yang sudah ada di server/. Detail kebijakan penyimpanan, retensi data, dan harga (kalau ada) akan diumumkan terpisah begitu fitur ini matang.
• Belum final: karena masih tahap perintisan, fitur ini bisa berubah signifikan di rilis berikutnya. Ikuti tab Releases untuk update terbaru.

Kalau mau tetap kelola VPS sendiri (self-host), panduannya masih tersedia di bagian Deploy backend ke VPS.

Kenapa arsitekturnya begini

• Default: 100% lokal. API key disimpan di localStorage milik app di komputer user, dan panggilan ke provider (Claude/Gemini/OpenAI/Groq/dll) langsung dari app ke provider. Server chanthecno tidak pernah menyentuh isi obrolan.
• Backup ke VPS itu opsional, dipicu manual lewat tombol "Cadangkan". User diidentifikasi lewat deviceId acak (UUID) yang dibuat otomatis saat pertama kali pakai app — bukan akun/password. Simpel, tapi tetap personal per-instalasi.
• API key yang di-backup dienkripsi (AES-256-GCM) di server sebelum ditulis ke disk, pakai MASTER_KEY yang hanya kamu pegang.

⚠️ Tanggung jawab keamanan: begitu ada satu user pakai fitur backup, kamu jadi memegang API key asli mereka (walau terenkripsi saat disimpan). Jaga MASTER_KEY di luar repo, pakai HTTPS di VPS (lihat bagian Nginx di bawah), dan pertimbangkan fitur "hapus data saya" untuk user yang mau berhenti pakai backup.

Provider yang didukung

Selain Claude (Anthropic), OpenAI, dan Google Gemini secara native, app ini juga bisa disambungkan ke endpoint custom apa pun yang OpenAI-compatible — termasuk Groq (gratis & cepat untuk eksperimen). Untuk provider custom, isi:

Field	Isi
Endpoint	https://api.groq.com/openai/v1/chat/completions
API Key	key dari console provider terkait
Model	cek daftar model aktif via GET /v1/models di provider tersebut

Menjalankan mode development

Prasyarat

• Node.js 18+
• Rust
• Tauri CLI: cargo install tauri-cli
• Linux (Debian/Ubuntu/Mint): paket dev GTK & WebKit —

sudo apt install -y libwebkit2gtk-4.1-dev build-essential curl wget file \
  libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev \
  libgtk-3-dev pkg-config

(lihat juga prasyarat resmi Tauri)

Jalankan app desktop

cargo tauri dev

Ini buka jendela app langsung dari folder dist/ — gak perlu bundler tambahan karena frontend-nya vanilla HTML/CSS/JS.

Jalankan backend (opsional, kalau mau test fitur backup)

cd server
cp .env.example .env      # lalu isi MASTER_KEY dengan: openssl rand -hex 32
npm install
npm run dev

Server jalan di http://localhost:3000. Isi URL itu di kolom "Backup" pada app buat nyoba — bukan untuk dibuka langsung di browser, karena ini API polos tanpa halaman UI.

Install lewat GitHub Release (tanpa build sendiri)

Cara paling gampang buat siapa pun yang cuma mau pakai, bukan develop:

1. Buka tab Releases dan pilih versi v1.2.2
2. Download installer sesuai OS:
   • Debian/Ubuntu/Linux Mint → .deb
   • Fedora/RHEL-based → .rpm
   • Distro apa pun (tanpa install) → .AppImage
   • Windows → .msi / .exe
3. Install & buka seperti app biasa

Build installer sendiri (Windows .msi/.exe, Linux .deb/.AppImage)

Paling gampang lewat GitHub Actions (sudah disiapkan di .github/workflows/build.yml) — kamu gak perlu install toolchain Windows di Linux:

1. Push project ini ke GitHub
2. Buat tag versi, misalnya: git tag v1.2.2 && git push origin v1.2.2
3. Actions otomatis build untuk Linux & Windows, lalu bikin Draft Release berisi installer-nya
4. Review draft-nya di tab "Releases", lalu publish

Build Linux dijalankan di runner ubuntu-22.04 (bukan ubuntu-latest) supaya binary yang dihasilkan tetap kompatibel dengan sistem yang GLIBC-nya lebih lama, seperti Linux Mint 21.x.

Build manual (kalau mau coba di komputer sendiri dulu):

cargo tauri build

Hasilnya ada di src-tauri/target/release/bundle/.

Deploy backend ke VPS

1. git clone repo ini di VPS, masuk ke folder server/
2. cp .env.example .env, isi MASTER_KEY acak & rahasia
3. npm install --production
4. Jalankan dengan process manager:

npm install -g pm2
pm2 start server.js --name chanthecno

5. Pasang reverse proxy + SSL gratis (Nginx + Certbot) supaya diakses via https:// — API key jangan pernah dikirim lewat HTTP biasa
6. data.json di folder server/ adalah "database" sederhana — cukup untuk tahap dev; kalau user makin banyak, ganti ke SQLite/Postgres

Roadmap yang masuk akal

• Riwayat chat tersimpan lokal antar sesi (sudah otomatis via localStorage, tinggal ditambah UI daftar percakapan)
• Export/import riwayat chat sebagai file
• Auto-update lewat Tauri updater
• Ganti data.json di backend ke SQLite kalau user mulai banyak
• UI untuk atur system prompt/persona AI tanpa edit kode
• Build Windows yang stabil di GitHub Actions

---

Dibuat oleh Candri

# chanthecno

v1.2.2

Aplikasi desktop chat AI open-source — bawa API key sendiri, tanpa akun, tanpa perantara.

🚧 v1.2.2 — Awal pengembangan fitur Pro. Mulai versi ini, chanthecno merintis fitur Pro: VPS terkelola dari chanthecno untuk menyimpan/mem-backup API key user (bukan lagi cuma opsi self-host server/ sendiri). Ini masih tahap awal/beta — arsitektur default (100% lokal, bawa API key sendiri) tidak berubah dan tetap jadi mode utama. Lihat [Fitur Pro (Beta)](#fitur-pro-beta) di bawah.

---

Apa ini

chanthecno adalah aplikasi desktop untuk chat dengan AI, di mana user bawa API key sendiri (Claude, Gemini, GPT, atau endpoint OpenAI-compatible seperti Groq). Request dikirim langsung dari perangkat user ke provider — tidak ada perantara, tidak ada sistem akun/login.

chanthecno/
├── dist/                   # Frontend (HTML/CSS/JS) — inilah yang tampil di jendela app
├── src-tauri/               # Shell desktop (Rust + Tauri)
├── server/                   # Backend VPS OPSIONAL — backup API key terenkripsi
└── .github/workflows/        # Build otomatis installer Windows & Linux

Daftar isi

• [Fitur Pro (Beta)](#fitur-pro-beta)
• [Kenapa arsitekturnya begini](#kenapa-arsitekturnya-begini)
• [Provider yang didukung](#provider-yang-didukung)
• [Menjalankan mode development](#menjalankan-mode-development)
• [Install lewat GitHub Release](#install-lewat-github-release-tanpa-build-sendiri)
• [Build installer sendiri](#build-installer-sendiri-windows-msiexe-linux-debappimage)
• [Deploy backend ke VPS](#deploy-backend-ke-vps)
• [Roadmap](#roadmap-yang-masuk-akal)

Fitur Pro (Beta)

Mulai v1.2.2, chanthecno mulai merintis fitur Pro: alih-alih user harus deploy dan kelola server/ sendiri di VPS pribadi buat fitur backup, chanthecno akan menyediakan VPS terkelola langsung dari tim chanthecno.

Beberapa poin penting soal arah fitur ini (masih berkembang, bisa berubah):

• Status: tahap awal/beta. Belum jadi pengganti mode default — user yang tidak butuh backup tetap bisa pakai app 100% lokal seperti biasa, tanpa terhubung ke VPS mana pun.
• Tujuan: user yang mau fitur backup API key tidak perlu repot setup server, MASTER_KEY, atau reverse proxy sendiri — cukup aktifkan Pro dan chanthecno yang mengurus infrastrukturnya.
• Keamanan tetap prioritas: rencananya API key tetap dienkripsi (AES-256-GCM) sebelum disimpan, sama seperti skema self-host yang sudah ada di server/. Detail kebijakan penyimpanan, retensi data, dan harga (kalau ada) akan diumumkan terpisah begitu fitur ini matang.
• Belum final: karena masih tahap perintisan, fitur ini bisa berubah signifikan di rilis berikutnya. Ikuti tab [Releases](https://github.com/candripanjaitan16/chanthecno/releases) untuk update terbaru.

Kalau mau tetap kelola VPS sendiri (self-host), panduannya masih tersedia di bagian [Deploy backend ke VPS](#deploy-backend-ke-vps).

Kenapa arsitekturnya begini

• Default: 100% lokal. API key disimpan di localStorage milik app di komputer user, dan panggilan ke provider (Claude/Gemini/OpenAI/Groq/dll) langsung dari app ke provider. Server chanthecno tidak pernah menyentuh isi obrolan.
• Backup ke VPS itu opsional, dipicu manual lewat tombol "Cadangkan". User diidentifikasi lewat deviceId acak (UUID) yang dibuat otomatis saat pertama kali pakai app — bukan akun/password. Simpel, tapi tetap personal per-instalasi.
• API key yang di-backup dienkripsi (AES-256-GCM) di server sebelum ditulis ke disk, pakai MASTER_KEY yang hanya kamu pegang.

⚠️ Tanggung jawab keamanan: begitu ada satu user pakai fitur backup, kamu jadi memegang API key asli mereka (walau terenkripsi saat disimpan). Jaga MASTER_KEY di luar repo, pakai HTTPS di VPS (lihat bagian Nginx di bawah), dan pertimbangkan fitur "hapus data saya" untuk user yang mau berhenti pakai backup.

Provider yang didukung

Selain Claude (Anthropic), OpenAI, dan Google Gemini secara native, app ini juga bisa disambungkan ke endpoint custom apa pun yang OpenAI-compatible — termasuk [Groq](https://console.groq.com/keys) (gratis & cepat untuk eksperimen). Untuk provider custom, isi:

Field	Isi
Endpoint	https://api.groq.com/openai/v1/chat/completions
API Key	key dari console provider terkait
Model	cek daftar model aktif via GET /v1/models di provider tersebut

Menjalankan mode development

Prasyarat

• [Node.js](https://nodejs.org) 18+
• [Rust](https://rustup.rs)
• Tauri CLI: cargo install tauri-cli
• Linux (Debian/Ubuntu/Mint): paket dev GTK & WebKit —

sudo apt install -y libwebkit2gtk-4.1-dev build-essential curl wget file \
  libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev \
  libgtk-3-dev pkg-config

(lihat juga [prasyarat resmi Tauri](https://tauri.app/start/prerequisites/))

Jalankan app desktop

cargo tauri dev

Ini buka jendela app langsung dari folder dist/ — gak perlu bundler tambahan karena frontend-nya vanilla HTML/CSS/JS.

Jalankan backend (opsional, kalau mau test fitur backup)

cd server
cp .env.example .env      # lalu isi MASTER_KEY dengan: openssl rand -hex 32
npm install
npm run dev

Server jalan di http://localhost:3000. Isi URL itu di kolom "Backup" pada app buat nyoba — bukan untuk dibuka langsung di browser, karena ini API polos tanpa halaman UI.

Install lewat GitHub Release (tanpa build sendiri)

Cara paling gampang buat siapa pun yang cuma mau pakai, bukan develop:

1. Buka tab [Releases](https://github.com/candripanjaitan16/chanthecno/releases) dan pilih versi v1.2.2
2. Download installer sesuai OS:
   • Debian/Ubuntu/Linux Mint → .deb
   • Fedora/RHEL-based → .rpm
   • Distro apa pun (tanpa install) → .AppImage
   • Windows → .msi / .exe
3. Install & buka seperti app biasa

Build installer sendiri (Windows .msi/.exe, Linux .deb/.AppImage)

Paling gampang lewat GitHub Actions (sudah disiapkan di .github/workflows/build.yml) — kamu gak perlu install toolchain Windows di Linux:

1. Push project ini ke GitHub
2. Buat tag versi, misalnya: git tag v1.2.2 && git push origin v1.2.2
3. Actions otomatis build untuk Linux & Windows, lalu bikin Draft Release berisi installer-nya
4. Review draft-nya di tab "Releases", lalu publish

Build Linux dijalankan di runner ubuntu-22.04 (bukan ubuntu-latest) supaya binary yang dihasilkan tetap kompatibel dengan sistem yang GLIBC-nya lebih lama, seperti Linux Mint 21.x.

Build manual (kalau mau coba di komputer sendiri dulu):

cargo tauri build

Hasilnya ada di src-tauri/target/release/bundle/.

Deploy backend ke VPS

1. git clone repo ini di VPS, masuk ke folder server/
2. cp .env.example .env, isi MASTER_KEY acak & rahasia
3. npm install --production
4. Jalankan dengan process manager:

npm install -g pm2
pm2 start server.js --name chanthecno

5. Pasang reverse proxy + SSL gratis (Nginx + Certbot) supaya diakses via https:// — API key jangan pernah dikirim lewat HTTP biasa
6. data.json di folder server/ adalah "database" sederhana — cukup untuk tahap dev; kalau user makin banyak, ganti ke SQLite/Postgres

Roadmap yang masuk akal

• Riwayat chat tersimpan lokal antar sesi (sudah otomatis via localStorage, tinggal ditambah UI daftar percakapan)
• Export/import riwayat chat sebagai file
• Auto-update lewat Tauri updater
• Ganti data.json di backend ke SQLite kalau user mulai banyak
• UI untuk atur system prompt/persona AI tanpa edit kode
• Build Windows yang stabil di GitHub Actions

---

Dibuat oleh Candri