Yapay zekanizin en basindan beri sahip olmasi gereken hafiza.
-orange)
Neden · Hizli Baslangic · Karsilastirma · Katmanlar · Benchmarklar · API · Belgeler · FAQ
---
## Neden TrueMemory
**Gurultudeki sinyali bulur.** Yapay zekaniz binlerce mesaj gorur. TrueMemory hangilerinin gercekten onemli oldugunu belirler, ve gerisini atar. Manuel etiketleme yok, prompt muhendisligi yok. O sadece bilir.
**Zamanla daha keskin hale gelir.** Statik bir veritabani degildir. Sizinle birlikte buyuyen canli bir hafizadir. Fikrinizi degistirdiginizde celiskileri cozer, eski bilgileri gunceller ve bildiklerini pekistirir. Ne kadar uzun kullanirsiniz, o kadar iyi olur.
**Dusunmenize gerek kalmadan calisir.** TrueMemory konusmalarinizdan otomatik olarak anilari yakalar ve bir sonraki oturumunuza dogru olanlari otomatik olarak enjekte eder. Hicbir seyi manuel olarak kaydetmeniz veya aramaniz gerekmez. Her sey kendilginden olur.
**%100 yereldir.** Makinenizdeki tek bir SQLite dosyasi. Hicbir sey cihazinizdan cikmaz. Bulut yok, API anahtari gerekmez. Verileriniz sizindir.
> **TrueMemory olmadan:** "Hangi framework'u kullaniyoruz?" Bu hafta 12. kez soruluyor. Ajaniniz her oturuma amnezi ile baslar. Adinizi, stack'inizi veya dun soylediklerinizi bilmez.
>
> **TrueMemory ile:** Ajaniniz zaten FastAPI kullandiginizi, Pydantic v2 tercih ettiginizi ve auth middleware'inizin `src/auth/` icinde oldugunu bilir. Duzeltmelerinizi, tercihlerinizi ve kararlarinizi hatirlar. Her oturumda, sonsuza kadar.
---
## TrueMemory Nasil Karsilastirilir
| Sistem | LoCoMo | LongMemEval | Yerel-oncelikli | Otomatik yakalama | Lisans |
|--------|--------|-------------|:-----------:|:------------:|---------|
| **TrueMemory Pro** | **93.0%** | **92.0%** | ✅ | ✅ | AGPL-3.0 |
| **TrueMemory Base** | **87.7%** | **84.1%** | ✅ | ✅ | AGPL-3.0 |
| Mem0 | 61.4% | — | Kismi | ❌ | Apache-2.0 |
| Supermemory | 65.4% | — | ❌ | ❌ | Cloud API |
| MemOS | 75.8% | — | ✅ | ❌ | Apache-2.0 |
| ReadAgent | 79.5% | — | ❌ | ❌ | Research |
> Tum benchmarklar bagimsiz olarak tekrarlanabilir. Scriptler [`benchmarks/`](../benchmarks/) klasorunde yer almaktadir.
---
## Hizli Baslangic
### Claude Code / Claude CLI / Cursor / Codex CLI / Gemini CLI icin
```bash
curl -LsSf https://raw.githubusercontent.com/buildingjoshbetter/TrueMemory/main/install.sh | sh
```
> Her seyi izole bir ortamda kurar. ~1,5 GB AI modeli indirir. Hicbir veri makinenizden cikmaz. sudo gerekmez.
Terminal'e yeni misiniz? Adim adim talimatlar icin buraya tiklayin.
1. **Terminal acin:** Mac: `Cmd + Space`, `Terminal` yazin. Linux: `Ctrl + Alt + T`. Windows: PowerShell acin.
2. **Yukaridaki komutu yapistirin** ve Enter'a basin.
3. **Modellerin indirilmesi icin 3-5 dakika bekleyin.**
4. **AI aracinizi tamamen kapatin** ve yeniden acin (Mac: `Cmd+Q`).
5. **"Set up TrueMemory" yazin** ve bir katman secin.
**Windows (PowerShell):**
```powershell
irm https://raw.githubusercontent.com/buildingjoshbetter/TrueMemory/main/install.ps1 | iex
```
Tum sistemlerin ayni yanit modelini (GPT-4.1-mini), yargici (GPT-4o-mini, 3x cogunluk oyu) ve puanlama hattini paylastigi uc buyuk benchmark uzerinde test edilmistir.
| Benchmark | Ne test eder | TrueMemory Pro |
|-----------|-------------|:--------------:|
| [LoCoMo](https://github.com/snap-research/locomo) | 10 konusmadan 1.540 soru | **93.0%** |
| [LongMemEval](https://github.com/xiaowu0162/LongMemEval) | 500 cok oturumlu soru | **92.0%** |
| [BEAM-1M](https://github.com/mohammadtavakoli78/BEAM) | 1M+ token'da 700 soru | **76.6% (SOTA)** |
| BEAM-10M | 10M token'da 200 soru | **65.0%** |
### Herhangi bir sonucu kendiniz yeniden uretin
Her benchmark scripti baglimsizdir ve [Modal](https://modal.com) uzerinde calisir.
- **[LoCoMo Scriptleri](../benchmarks/locomo/scripts/)** — 8 sistem (TrueMemory, Mem0, Zep, Engram, vb.)
- **[LoCoMo Sonuclari](../benchmarks/locomo/BENCHMARK_RESULTS.md)** — kategori bazinda dokumler, gecikme, maliyet
- **[LoCoMo Eval Yapilandirmasi](../benchmarks/locomo/EVAL_CONFIG.md)** — tam modeller, promptlar, parametreler
- **[LongMemEval Scriptleri](../benchmarks/longmemeval/)** — oracle + strict varyantlari
- **[LongMemEval Sonuclari](../benchmarks/longmemeval/results/)** — 6 TM Pro calismasi + 5 rakip sonucu
- **[BEAM-1M Scripti](../benchmarks/beam/bench_truememory_pro_beam1m.py)** — 1M+ token'da 35 konusma
- **[BEAM-10M Scripti](../benchmarks/beam/bench_truememory_pro_beam10m.py)** — 10M token'da 10 konusma
- **[BEAM Sonuclari](../benchmarks/beam/)** — 3 calisma (1M) + 1 calisma (10M)
Tum benchmarklar ayni degerlendirme hattini kullanir. Hicbir sey gizli degildir. Tam detaylar: [LoCoMo](../benchmarks/locomo/EVAL_CONFIG.md) | [LongMemEval](../benchmarks/longmemeval/README.md) | [BEAM](../benchmarks/beam/README.md)
---
## Uyumlu Olduklari
Claude Code · Claude CLI · Cursor · Codex CLI · Gemini CLI · Claude Desktop
Lifecycle hook'lari konusmalari otomatik olarak yakalar. Manuel islem gerekmez. Anilariniz tek bir SQLite dosyasinda yerel olarak kalir.
---
## Python API
```python
from truememory import Memory
m = Memory()
m.add("Prefers dark mode and TypeScript", user_id="alex")
m.add("Works at Anthropic as a senior engineer", user_id="alex")
results = m.search("What are Alex's preferences?", user_id="alex")
results = m.search_deep("career history?", user_id="alex") # multi-round, higher accuracy
```
| Metot | Aciklama |
|-------|----------|
| `m.add(content, user_id)` | Bir ani kaydet |
| `m.search(query, user_id)` | Arama (6 katmanli hat + reranker) |
| `m.search_deep(query, user_id)` | Cok turlu ajantik arama |
| `m.get(id)` / `m.get_all(user_id)` | Anilari getir |
| `m.update(id, content)` / `m.delete(id)` | Degistir veya sil |
| `m.stats()` | Sistem istatistikleri |
[Tam API referansi →](../docs/python-api.md)
---
## Belgeler
| | |
|---|---|
| [Baslarken](../docs/guides/getting-started.md) | Kurulumdan ilk aniya |
| [Python API Referansi](../docs/python-api.md) | Tam `Memory` sinif referansi |
| [MCP Arac Referansi](../docs/mcp-tools.md) | 8 MCP araci |
| [CLI Referansi](../docs/cli.md) | `truememory-mcp` ve `truememory-ingest` |
| [Ortam Degiskenleri](../docs/env-vars.md) | Tum `TRUEMEMORY_*` yapilandirma secenekleri |
| [Mimari Derinlemesine](../docs/architecture.md) | 6 katmanli erisim hatti, encoding gate |
| [Katman Secim Kilavuzu](../docs/guides/tier-selection.md) | Edge vs Base vs Pro |
| [Hata Ayiklama](../docs/guides/debugging.md) | Loglar, izler, yaygin sorunlar |
---
## FAQ
Verilerim nerede saklanir? Buluta bir sey gonderiliyor mu?
Her sey yerel olarak `~/.truememory/memories.db` dosyasinda yer alir. Edge ve Base katmanlari hicbir harici cagri yapmaz. Pro yalnizca arama sorgu metninizi sorgu genisletme icin bir LLM'ye gonderir. Anilariniz asla iletilmez.
Python kurulu olmasi gerekiyor mu?
Hayir. Yukleyici, korumalanmis bir Python 3.12 ortamini yonetmek icin [uv](https://docs.astral.sh/uv/) kullanir. Sistem Python'unuz dokunulmaz.
Neden sadece daha buyuk bir context window kullanmiyorsunuz?
Context window'lar pahali, yavas ve her oturumun basinda bostur. TrueMemory sifir token baglam ile 200 ms'nin altinda aninda geri cagirma saglar.
TrueMemory telemetri topluyor mu?
Anonim kullanim telemetrisi (arac cagrilari, oturum sayilari, platform bilgisi) varsayilan olarak aciktir. Ani iceriklerini, sorguları, dosya yollarini veya API anahtarlarini **asla** takip etmeyiz. Devre disi birakin: `export TRUEMEMORY_TELEMETRY=off`
TrueMemory, bir sauron sirketi
