📚 Pusat Edukasi & Dokumentasi Resmi EverOS

Solusi "Amnesia" pada AI.
Memori Jangka Panjang di Server Sendiri.

Pelajari bagaimana EverOS bekerja dari A sampai Z: mengapa model AI membutuhkan memori mandiri, bagaimana fakta diekstraksi menjadi pengetahuan abadi, dan bagaimana Anda dapat memanfaatkannya pada proyek Anda sendiri.

1. Apa & Kenapa EverOS Diperlukan?

Memahami konsep dasar memori AI, keterbatasan model bahasa besar (LLM), dan mengapa kedaulatan data sangat berharga.

💡

Apa itu EverOS?

EverOS adalah sistem memori jangka panjang (Long-Term Memory Platform) mandiri untuk asisten AI dan agen otomatis.

Analogi Sederhana:
Jika AI biasa seperti pekerja cerdas yang kehilangan ingatannya setiap kali tidur atau menutup chat, maka EverOS adalah buku catatan digital abadi miliknya. Di sanalah ia mencatat siapa Anda, apa yang sudah disepakati, keputusan teknis masa lalu, dan aturan penting.
  • Menyimpan informasi penting lintas sesi obrolan.
  • Mengubah percakapan panjang menjadi fakta ringkas (Atomic Facts).
  • Database memori tersimpan di VPS sendiri; ekstraksi fakta memakai API OpenAI.
❓

Kenapa EverOS Dibutuhkan?

Model AI seperti Claude, ChatGPT, atau model open-source memiliki masalah mendasar: Amnesia Sesi.

Masalah Nyata:
• Setiap buka sesi baru, Anda harus menjelaskan ulang konteks proyek dari nol.
• Memasukkan seluruh riwayat chat ke context window membuang ribuan token dan biayanya mahal.
• AI mudah bingung jika dibebani riwayat ratusan ribu kata sekaligus ("needle in a haystack").
  • Hemat Waktu: Anda tidak perlu berulang kali mengajarkan hal yang sama.
  • Presisi: AI hanya memanggil konteks yang relevan dengan pertanyaan saat ini.
  • Efisien: Context window tetap bersih dan respons AI tetap tajam.
🔒

Kenapa Harus Self-Hosted?

Banyak layanan memori AI komersial yang mengharuskan Anda mengirimkan seluruh histori dan rahasia bisnis ke server mereka.

Kedaulatan Penuh (Data Sovereignty):
Dengan EverOS Self-Hosted di server VPS pribadi, database (SQLite & LanceDB) dan model embedding (mxbai-embed-large) berada di server Anda sendiri. Ekstraksi fakta memakai API OpenAI (gpt-6-luna), sehingga isi memori yang disimpan ikut dikirim ke OpenAI untuk diproses.
  • Nol Langganan SaaS: Bebas biaya bulanan per-API memory berbayar.
  • Batas Data: Jangan simpan rahasia, kredensial, atau data CONFIDENTIAL; isi memori diproses oleh OpenAI saat ekstraksi.
  • Akses Internal: Inti sistem hanya terbuka di loopback (`127.0.0.1`).

2. Bagaimana Cara Kerja EverOS di Balik Layar?

Dua siklus utama yang membuat agen AI mampu mengingat dan memanggil kembali memori secara instan.

SIKLUS 1: PENYIMPANAN

📥 Proses Mengingat (Remember & Extraction)

Ketika agen AI menyimpan percakapan atau fakta baru:

1
Penerimaan Pesan (`/api/v2/memory/add`): Pesan teks dan metadata pengguna masuk ke memori kerja (working buffer) di SQLite.
2
Pemicuan Flush (`/api/v2/memory/flush`): Sistem menandai bahwa sesi tersebut siap diringkas dan diekstrak oleh worker latar belakang (Cascade).
3
Ekstraksi Cerdas oleh LLM (OpenAI gpt-6-luna): Model LLM menganalisis percakapan untuk mengekstrak Atomic Facts (fakta inti tunggal), User Profile (preferensi pengguna), dan Episode Summary.
4
Pengindeksan Persisten: Fakta disimpan secara permanen di SQLite dan diindeks agar siap dicari secara sekejap di kemudian hari.
SIKLUS 2: PEMULIHAN

🔍 Proses Pemanggilan (Recall & Context Injection)

Ketika Anda memulai percakapan baru atau mengajukan pertanyaan:

1
Kueri Alami (`/api/v2/memory/search`): Asisten AI mengirimkan pertanyaan Anda (misal: "Apa keputusan arsitektur database kita?") ke EverOS.
2
Pencarian Cepat Berbasis Keyword & Episode: EverOS menyaring ribuan data memori dan memilih top_k episode serta fakta atomik yang paling relevan.
3
Penyuntikan Konteks Ringkas: Hasil temuan disuntikkan secara rapi ke dalam prompt asisten AI.
4
Jawaban Cerdas & Konsisten: AI langsung menjawab dengan mengetahui seluruh sejarah proyek, tanpa Anda harus menjelaskan ulang!

3. Glosarium Istilah EverOS dari A sampai Z

Daftar istilah penting dalam arsitektur EverOS dan sistem memori AI yang dijelaskan dengan bahasa yang lugas dan mudah dipahami.

A

Atomic Fact

Potongan informasi terkecil yang mandiri dan tidak dapat dibagi lagi. Contoh: alih-alih menyimpan paragraf panjang, EverOS menyimpan "Domain proyek adalah everos.khelmi.biz.id" dan "Model inferensi yang digunakan adalah qwen3:8b". Ini membuat pencarian jauh lebih akurat.

A

App ID (Namespace)

Pemilah atau ruang isolasi memori. Jika Anda memiliki beberapa proyek AI yang berbeda (misal: ai-bcomp-v2 dan everos), memori dari kedua proyek ini tidak akan bercampur karena dipisahkan oleh App ID masing-masing.

C

Cascade Worker

Pekerja latar belakang (background processor) di dalam EverOS yang bertugas mengekstrak fakta dan menyusun episode secara asinkron tanpa menahan atau memperlambat respon percakapan utama pengguna.

C

Context Window

Batas kapasitas teks atau jumlah kata yang dapat "dilihat" atau diproses oleh model kecerdasan buatan dalam satu interaksi. EverOS membantu agar context window tidak cepat penuh dengan hanya menyuntikkan fakta yang benar-benar dibutuhkan.

D

Drain Margin

Fitur ketahanan (resilience) yang diterapkan pada patch H5 EverOS. Saat server hendak dimatikan atau di-restart, sistem memberikan jeda waktu terkontrol agar pekerjaan penulisan memori yang sedang berjalan dapat diselesaikan dengan tuntas tanpa terjadi korupsi data.

E

Episode

Kumpulan interaksi atau satu sesi kejadian yang dirangkum menjadi satu cerita terstruktur. Berisi waktu kejadian, ringkasan situasi, dan daftar fakta atomik yang terjadi dalam sesi tersebut.

E

Episodic Memory

Jenis memori yang menyimpan pengalaman atau kejadian di masa lalu secara berurutan waktu (apa yang terjadi, kapan terjadi, dan apa hasil akhirnya).

F

Flush

Perintah untuk "membekukan" dan memproses seluruh pesan sementara di memori kerja (buffer) agar diubah menjadi memori permanen melalui ekstraksi oleh model LLM.

H

H5 Graceful Recovery

Tingkat pengerasan operasional (operational hardening milestone ke-5) pada instalasi server ini. Memastikan bahwa apabila server mendadak mati atau di-kill, seluruh baris memori yang berstatus 'running' akan otomatis dipulihkan menjadi status sukses saat sistem dinyalakan kembali.

K

Keyword Search (BM25)

Metode pencarian memori berkecepatan tinggi berbasis pencocokan kata kunci penting. Metode ini sangat hemat CPU dan tidak membutuhkan model embedding berat, sehingga sangat ideal untuk server mandiri yang efisien.

L

LanceDB

Database vektor embedded modern berbasis berkas (file-based) yang ringan dan cepat, digunakan untuk menyimpan indeks semantik dan pencarian kemiripan konteks.

L

Loopback-Only

Standar keamanan ketat di mana port layanan (seperti port 3012, 11434, dan 11435) hanya bisa diakses dari dalam server itu sendiri (alamat 127.0.0.1). Layanan tidak bisa diakses langsung dari internet luar tanpa melalui Nginx reverse proxy yang terautentikasi.

M

MCP (Model Context Protocol)

Standar protokol terbuka yang dipelopori oleh Anthropic yang memungkinkan alat AI seperti Claude Code berinteraksi langsung dengan tool eksternal (seperti perintah everos_remember dan everos_recall).

O

OME (Observation Memory Engine)

Komponen analitis di dalam EverOS yang bertugas menyaring mana pembicaraan yang layak diingat sebagai fakta jangka panjang dan mana yang sekadar sapaan obrolan biasa.

Q

Qwen3:8b

Model bahasa sumber terbuka (open-weight) mutakhir berukuran 8 miliar parameter yang dijalankan di server VPS via Ollama. Dipakai sebagai model ekstraksi lokal sampai 26 September 2026; sejak itu ekstraksi memakai API OpenAI.

R

Recall (Pencarian)

Proses mencari dan memanggil kembali memori atau fakta yang relevan dari bank data EverOS berdasarkan kueri pengguna atau kebutuhan agen AI saat ini.

R

Remember (Perekaman)

Aksi memasukkan informasi, keputusan teknis, atau catatan baru ke dalam sistem EverOS agar diolah menjadi pengetahuan yang abadi.

S

Shim Proxy (No-Think Shim)

Layanan penengah cerdas (berjalan di port 11435) yang mengatur antrean inferensi 1-slot ke Ollama. Shim ini memastikan model Qwen merespons cepat tanpa loop pemikiran yang tidak perlu (reasoning_effort=none) dan mencegah server kehabisan memori. Sejak 26 September 2026 ekstraksi memori tidak lagi melalui shim ini.

S

Sovereign AI

Prinsip kemandirian kecerdasan buatan, di mana seluruh model, data memori, dan infrastruktur komputasi dikuasai dan dikelola sendiri oleh pemilik tanpa risiko sensor, perubahan harga sepihak, atau penyadapan pihak ketiga.

U

User Profile Memory

Sub-sistem memori yang mencatat profil, preferensi kerja, dan pola kebiasaan pengguna secara spesifik sehingga respon AI terasa personal dan tidak perlu disesuaikan berulang-ulang.

4. Integrasi Cepat ke Proyek Anda

Hubungkan asisten AI Anda ke EverOS melalui MCP Claude Code. Tidak ada API publik: klien menjangkau inti lewat terowongan SSH berbasis kunci ke loopback server.

SANGAT DISARANKAN
⚡

Claude Code MCP Server

Daftarkan sekali di laptop/PC Anda, dan seluruh sesi Claude Code otomatis memiliki memori jangka panjang.

claude mcp add --global everos python "E:/everos/runtime/mcp-everos/server.py" \
  -e EVEROS_TOKEN="TOKEN_BEARER_ANDA" \
  -e EVEROS_USER="khelmi" \
  -e EVEROS_APP="ai-bcomp-v2"
✓ Menyediakan tool otomatis: everos_remember & everos_recall
✓ Ekstraksi latar belakang tanpa memperlambat interaksi kerja
✓ Terhubung lewat terowongan SSH ke 127.0.0.1:3012; inti tidak terbuka ke internet

5. Pertanyaan yang Sering Diajukan (FAQ)

Jawaban ringkas dan jelas untuk pertanyaan teknis maupun operasional seputar EverOS.

Ya, untuk ekstraksi. Saat memori disimpan, isi percakapan dikirim ke API OpenAI (model gpt-6-luna) untuk mengekstrak fakta. Database SQLite dan LanceDB serta embedding (mxbai-embed-large via Ollama) tetap berada di VPS. Karena itu jangan simpan rahasia, kredensial, atau data CONFIDENTIAL ke EverOS.

RAG tradisional biasanya hanya memecah dokumen menjadi potongan-potongan (chunks) lalu mencocokkannya. Sebaliknya, EverOS memiliki lapisan kognitif (Memory Engine) yang secara aktif menyaring: apa yang berubah dari pemikiran pengguna, apa fakta atomik baru yang lahir, bagaimana profil pengguna berevolusi, dan bagaimana episode sesi masa lalu saling terhubung. Ini menghasilkan konteks yang jauh lebih terstruktur dan ringkas bagi agen AI.

Pencarian berbasis kata kunci (keyword BM25) mengeksekusi pencarian dalam hitungan milidetik dengan konsumsi memori dan daya CPU yang sangat rendah. Karena server ini juga menjalankan model embedding secara mandiri, metode keyword memberikan efisiensi komputasi maksimal tanpa risiko kehabisan RAM (Out-of-Memory).

Token Bearer EverOS tidak boleh di-commit ke repositori publik seperti GitHub. Simpan token di dalam file konfigurasi lokal tersembunyi (misal di ~/.bashrc, variabel lingkungan .env, atau konfigurasi MCP Claude Code).

6. Arsitektur Loopback Mandiri (Sovereign Topology)

Situs ini statis dan tidak terhubung ke inti. Inti hanya dapat dijangkau dari dalam server atau lewat terowongan SSH operator.

AKSES OPERATOR
Terowongan SSH
Kunci SSH, tanpa API publik
Loopback (Bearer Auth)
INTERNAL PORT 3012
EverOS Runtime (v1.2.3+H5)
Uvicorn • APScheduler • SQLite
Antrean FIFO 1-Slot
API EKSTERNAL HTTPS
OpenAI API
Ekstraksi: gpt-6-luna
Embedding (dari runtime, lokal)
INTERNAL PORT 11434
Ollama Lokal
Model: mxbai-embed-large (Embedding)