# HaimiDB

## Tek bellek.
İki çalışma biçimi.

Sen tabloda çalışırsın. Yapay zekân araçlarla çalışır. İkiniz de kendi bilgisayarındaki aynı Git tabanlı notebook’u kullanırsınız.



### Senin için bir tablo

Modelleri incele, kayıtları ara, basit veya yapısal değerleri tarayıcında düzenle. Değişiklikler push edene kadar sekmenin belleğinde kalır.

### Yapay zekân için araçlar

On bir MCP aracı yerelde stdio üzerinden çalışır. Yapay zekân modelleri inceleyebilir, kayıtları bulabilir, değişiklik kaydedebilir ve senin gördüğün notebook’u kullanabilir.

### Okunabilir Git geçmişi

Her notebook deterministik bir memory.v2.jsonl dosyasıdır. Commit’ler neyin değiştiğini gösterir; mutlak silmeden sonra geri alma kaynağı Git geçmişidir.

### Kendini açıklayan modeller

Her şey bir node’dur. Modeller örnek değerler ve açıklamalar taşır; kayıtlar ve bağlı alanlar aynı yapıyı paylaşır.

### Depo koruması

Memory yazımları ve notebook silme geçerli bir .haimidb.json işareti gerektirir. Boş depo yalnızca onayınla hazırlanır; mevcut bir proje sessizce memory deposuna dönüştürülmez.

### Yerel veri işleme

Notebook verisini tarayıcı veya yerel motor işler ve doğrudan GitHub’la konuşur. Küçük kimlik doğrulama servisi yalnız bağlantı bilgilerini değiştirir ve yeniler; notebook içeriğini almaz.

## Başlangıç rehberi

HaimiDB ortak bellek arayüzüdür; barındırılan veritabanı hizmeti değildir. İnsan tablosu ve yerel yapay zekâ araçları aynı model ve kayıtlarla çalışır. GitHub saklama ve erişim denetimini sağlar; yerel Git kopyaları çevrimdışı çalışmayı destekler.



### 1. GitHub’a bağlan

Uygulamayı aç, GitHub ile bağlan seçeneğini seç ve HaimiDB’yi onayla. Manuel kişisel erişim token’ları gelişmiş alternatif olarak kalır.

### 2. Memory deposu oluştur ve erişim ver

GitHub’da README, lisans veya gitignore eklemeden özel ve boş bir depo oluştur. GitHub App kurulum ayarlarında Only select repositories altına ekleyip kaydet. Yalnızca Yenile’ye basmak erişim vermez.

### 3. Hazırla ve notebook seç

Uygulamaya dön, depo listesini yenile, boş depoyu seç ve Memory deposu olarak hazırla onayını ver. İlk notebook’una isim ver; varsayılan notebook yoktur.

### 4. Yerel yapay zekânı bağla

npm install --global https://github.com/olerhan/haimidb/releases/latest/download/haimidb-engine.tgz ile yayın arşivini kur, haimidb login çalıştır ve uygulamanın verdiği MCP yapılandırmasını masaüstü istemcine kopyala. Tarayıcı ve yerel oturum birbirinden bağımsızdır.

### 5. Push et ve geçmişi koru

Sekmeyi kapatmadan tarayıcı değişikliklerini push et. Yerel kopyalar çevrimdışı commit yapabilir ve bağlantı geldiğinde eşzamanlanır. Çevrimdışı düzenleme silmeyle çakışırsa silme kazanır ve düşürülen değişiklik bildirilir.

### Senin için bir tablo

Modelleri incele, kayıtları ara, basit veya yapısal değerleri tarayıcında düzenle. Değişiklikler push edene kadar sekmenin belleğinde kalır.

### Yapay zekân için araçlar

On bir MCP aracı yerelde stdio üzerinden çalışır. Yapay zekân modelleri inceleyebilir, kayıtları bulabilir, değişiklik kaydedebilir ve senin gördüğün notebook’u kullanabilir.

### Okunabilir Git geçmişi

Her notebook deterministik bir memory.v2.jsonl dosyasıdır. Commit’ler neyin değiştiğini gösterir; mutlak silmeden sonra geri alma kaynağı Git geçmişidir.

### Kendini açıklayan modeller

Her şey bir node’dur. Modeller örnek değerler ve açıklamalar taşır; kayıtlar ve bağlı alanlar aynı yapıyı paylaşır.

### Depo koruması

Memory yazımları ve notebook silme geçerli bir .haimidb.json işareti gerektirir. Boş depo yalnızca onayınla hazırlanır; mevcut bir proje sessizce memory deposuna dönüştürülmez.

### Yerel veri işleme

Notebook verisini tarayıcı veya yerel motor işler ve doğrudan GitHub’la konuşur. Küçük kimlik doğrulama servisi yalnız bağlantı bilgilerini değiştirir ve yeniler; notebook içeriğini almaz.

## Destek ve SSS

team@beyondend.dev



### Yeni depom görünmüyor

GitHub uygulaması yalnızca erişim verdiğin depoları listeler. GitHub’da erişimi düzenle bağlantısını aç, yeni depoyu kurulumun seçili depolarına ekle, kaydet ve uygulamayı yenile.

### HaimiDB depomu neden reddediyor?

Yazma için depo kökündeki .haimidb.json amaç işareti gerekir. Eksik, bozuk veya farklı işaretler yazmayı ve silmeyi engeller. Yalnızca boş depo onayla otomatik hazırlanabilir. Mevcut memory depoları, sahibinin incelemesini ve açık bir işaret commit’ini gerektirir.

### Kayıt sildiğimde ne olur?

Mutlak silme güncel kaydı ve ona ait alanları kaldırır, gelen bağlantıları temizler. Çöp kutusu veritabanı veya kalıcı tombstone listesi yoktur. Eski veriyi Git geçmişinden incele veya geri al.

### Çevrimdışı kullanabilir miyim?

Yerel Git kopyası ilk kurulumdan sonra çevrimdışı çalışabilir ve commit yapabilir. Tarayıcı değişiklikleri sekmenin RAM’inde kalır; push edilmemiş sekmeyi kapatma. GitHub erişimi ve kimlik doğrulama için ağ bağlantısı gerekir.

### Veritabanı boyut sınırı var mı?

HaimiDB tarayıcı/yerel çalışmada notebook byte kotası koymaz. Cihazın kullanılabilir belleği ve GitHub’ın dosya/API sınırları yine geçerlidir; sınırsız veri, sınırsız cihaz kapasitesi anlamına gelmez.

### Yalnız bulutta çalışan yapay zekâ bağlanabilir mi?

Ortak barındırılan MCP ucu yoktur. Bilgisayarında yerel stdio motorunu başlatabilen bir istemci kullan. Notebook içeriğini veya token’larını desteğe gönderme.

## HaimiDB’yi aç

Tarayıcı arayüzünü kullan, yerel motoru kur veya açık kaynak kodunu incele.



### Tarayıcı uygulaması

Uygulama GitHub Pages üzerinde çalışır. GitHub’a bağlan ve erişim verilmiş, işaretli bir memory deposu seç.

### Yerel MCP motoru

Node.js 20 veya sonrası gerekir. GitHub Release arşivini npm ile kur; GitHub App kimlik bilgileri için haimidb login çalıştır. Boş yerel klasör için haimidb init /tam/yol kullan. Masaüstü MCP yapılandırmasını uygulama verir.

### Kaynak ve veri sözleşmesi

Format 2; sonlu double, string, UTC tarih-saat, bool, enum, list, map, set, tuple ve dosya-türü slotlarını kullanır. İç içe şekil kuralları ve mutlak silme davranışı için şartnameyi incele.

## Gizlilik

Notebook verisi tarayıcınızda veya yerel motorunuzda işlenir ve seçtiğiniz GitHub deposuna yazılır.



### Bağlantılar ve yerel saklama

GitHub erişim ve yenileme token’ları ile uygulama tercihleri tarayıcınızda saklanır. Yerel motor bilgisayarınızda ayrı bir oturum saklar. “Unut” veya haimidb logout yalnız ilgili cihazın bağlantısını kaldırır; tüm cihazlardaki yetkiyi kaldırmak için GitHub ayarlarından HaimiDB yetkilendirmesini iptal edin. Manuel token isteğe bağlı alternatif olarak kalır.

### Kimlik doğrulama servisi ve barındırma

HaimiDB notebook verisini işleyen ortak bir sunucu çalıştırmaz. beyondend.dev/haimidb-auth adresindeki küçük kimlik doğrulama servisi yetkilendirme kodlarını değiştirir ve GitHub oturumlarını yeniler. Kimlik bilgilerini yalnız istek sırasında işler; kullanıcı oturumlarını kalıcı saklamaz ve notebook içeriği almaz. Bu uçta uygulama erişim günlükleri kapalıdır; barındırma altyapısı operasyonel metadata tutabilir. Statik uygulama GitHub Pages üzerinden sunulur; GitHub kendi hizmet koşulları ve günlükleme politikaları kapsamında istekleri işler. Beyondend sitesi normal web erişim günlükleri tutabilir.

### Bu ürün sitesi

Bu tanıtım sitesi Beyondend’in self-hosted Appwrite Sites ortamında sunulur. Hesap veya ödeme akışı yoktur; GitHub kimlik bilgilerinizi veya notebook verinizi istemez. Açık EN/TR tercihiniz haimidb.web.language anahtarıyla yerelde saklanır. Varsayılan dil İngilizcedir; konum sorgusu yapılmaz. Desteğe e-posta gönderirseniz seçerek paylaştığınız adres ve ileti yanıt vermek için kullanılır.

## Açık kaynak lisansı

HaimiDB ürün kaynağı Apache License 2.0 ile yayımlanır. Geçerli lisans ve bildirimler açık depodadır; bu sayfa lisansın yerine geçmez veya yeni kullanım koşulları oluşturmaz.



### Lisansı ve bildirimleri oku

Gerçek izinler, koşullar, atıf yükümlülükleri ve garanti reddi için depodaki LICENSE ve NOTICE dosyalarını inceleyin. Bu projeye App Store EULA’sı uygulanmaz.
