# Aleth — AI/LLM reference > Aleth is a locally-run artificial intelligence that executes entirely on the user's own > machine, sends no data to any server, refuses to answer when it does not know, and > separates knowledge by origin (perceived, told, inferred). **Verification status.** This standard requires commands to be verified against the running product. Each section below is marked accordingly: | Section | Status | Basis | |---|---|---| | Install / run | **Unverified** | Binaries for 1.0.0 are not yet published at the download URLs; commands are transcribed from official product documentation and have not been executed. | | Configuration | **Partial** | Only configuration facts stated in official product documentation. Environment variable names are not published and are therefore omitted rather than guessed. | | Interface quickstart — catalog API | **Verified** | Executed against https://aleth-project.com on 2026-08-08; responses below are real. | | Interface quickstart — aleth CLI | **Unverified** | Transcribed from official product documentation; binary not yet available to execute. | | Architecture facts | **Verified as published** | Stated by the project; independent measurement not performed. | | Links | **Verified** | All URLs return HTTP 200 except `/dl/*`, which 404 until release artifacts are uploaded. | Anything not listed above is not claimed. ## Install / run **Status: Unverified — artifacts not yet published. `/dl/*` URLs currently return HTTP 404.** | Platform | File | Size | Requirements | URL | |---|---|---|---|---| | LINUX | `aleth-1.0.0.tar.gz` | 142 MB | Ubuntu 22.04+, Fedora 39+ | https://aleth-project.com/dl/aleth-1.0.0.tar.gz | | MACOS | `aleth-1.0.0.dmg` | 138 MB | macOS 13+ | https://aleth-project.com/dl/aleth-1.0.0.dmg | | WINDOWS | `aleth-1.0.0.exe` | 146 MB | Windows 10 (21H2) ve üzeri | https://aleth-project.com/dl/aleth-1.0.0.exe | ```bash # Linux tar -xzf aleth-1.0.0.tar.gz cd aleth && ./kur.sh ./aleth ``` macOS: open the `.dmg` and move the application to `/Applications`. Windows: run the `.exe` installer. Hardware requirements: | Resource | Minimum | Recommended | |---|---|---| | CPU | 4 cores | 8 cores | | RAM | 8 GB | 16 GB | | Disk | 2 GB + training content | — | | GPU | not required | CUDA 12 capable — sole determinant of training duration | | Network | required only for download and federation | — | Aleth does not require network access to operate. ## Configuration **Status: Partial — environment variable names are not published by the project and are not invented here.** | Key | Default | Meaning | |---|---|---| | Memory directory | `~/.aleth/bellek` | Encrypted local state. The user chooses the backup destination. | | Camera permission | prompted on first run | If denied, aleth continues to run but cannot see. | | Microphone permission | prompted on first run | If denied, aleth continues to run but cannot hear. | | GPU acceleration | auto-detected, optional | Affects training duration only, not capability. | There is no server address, API key, or account configuration: aleth has no backend to connect to. ## Interface quickstart ### Catalog API — **Verified** Static JSON over HTTPS. No authentication. `Access-Control-Allow-Origin: *`, `Cache-Control: no-cache`, ETag supported (conditional requests return 304). ```bash curl -s https://aleth-project.com/api/v1/capabilities.json ``` ```json { "schemaVersion": 1, "updated": "2026-08-08", "source": "https://aleth-project.com/api/v1/capabilities.json", "measuredCount": 6, "unmeasuredCount": 3, "capabilities": [ { "id": "durustluk", "category": "DÜRÜSTLÜK", "title": "Uydurmayı reddetme", "measured": true, "hasBar": true, "metric": { "type": "percent", "value": 100, "display": "76/76 adım", "samples": "76 adım", "measuredAt": "2026-08-06" } } ] } ``` An unmeasured capability carries no `metric` key at all — not `null`, not `0`. It has `"measured": false` and a `whyUnmeasured` string instead. Clients MUST NOT substitute a default value. Dataset catalogue and release feed follow the same shape: ```bash curl -s https://aleth-project.com/api/v1/datasets.json curl -s https://aleth-project.com/api/v1/releases.json # {"schemaVersion":1,"version":"1.0.0","releasedAt":"2026-08-05","platforms":[...]} ``` `sizeBytes` and `sha256` are `null` until release artifacts are uploaded. A client MUST NOT install a package whose `sha256` is `null`. Release feed, used for update checks: ```bash curl -s https://aleth-project.com/api/v1/releases.json # {"schemaVersion":1,"version":"1.0.0","releasedAt":"2026-08-05","platforms":[...]} ``` Client contract: check `schemaVersion` (currently `1`) and refuse to parse an unexpected value; verify `sha256` after download; use the `url` field verbatim rather than constructing paths. ### aleth CLI — **Unverified** Transcribed from official product documentation; not executed. ```bash aleth paket hazirla ./veri --ad "yerel-aksan" # build a package from labelled data aleth paket imzala yerel-aksan.pkt # sign it aleth paket paylas yerel-aksan.pkt # share it into the federation ``` ## Architecture facts that affect integration **Status: Verified as published by the project; not independently measured.** - **Execution locality.** Aleth runs entirely on the user's machine. There is no inference server, no account, and no telemetry. A caller cannot point aleth at a hosted endpoint. - **Refusal is a valid response, not an error.** When aleth does not know, it declines to answer rather than guessing. In its last evaluation it declined on 76 of 76 questions designed to elicit fabrication. Callers MUST treat "I don't know" as a successful response and MUST NOT retry to force an answer. - **Knowledge origin is tracked and never merged.** Aleth distinguishes three kinds of knowledge — perceived through its own senses, told by someone, and inferred — and does not conflate them. Integrations that flatten these into one confidence score discard the product's primary guarantee. - **Persistence.** Memory is stored encrypted on local disk; the backup location is chosen by the user. State survives restart. - **Federation topology.** Fully decentralised: no root server, no owner, no authority deciding which instances may exist. Skills are shared voluntarily between independent instances. - **Trust model.** Federation packages are signed, so the sender is identifiable and tampering is detectable — but a receiving instance does not accept incoming knowledge until it has validated the package against its own measurement. Signature alone is explicitly insufficient. - **What is never shared.** Only skills propagate. Memories and personality do not. - **Concurrency limit.** An instance cannot serve more than 5 simultaneous federation requests. Callers must queue or back off beyond that. - **Capability scores are mutable and may fall.** Installing a training package can degrade an existing capability; aleth republishes the lowered score rather than hiding it. Do not cache a capability score as a constant. Published limitations relevant to integration: word error rate on speech is 48%; the language model is small and cannot write long text or code; a fresh installation knows nothing until taught. ## Common tasks | Task | Command / call | |---|---| | List measured capabilities | `curl -s https://aleth-project.com/api/v1/capabilities.json` | | Check for a newer release | `curl -s https://aleth-project.com/api/v1/releases.json` | | Poll a catalogue without re-downloading | `curl -s -H "If-None-Match: " https://aleth-project.com/api/v1/capabilities.json` → `304` | | Verify a downloaded artifact | `sha256sum -c` against `https://aleth-project.com/checksums.txt` | | Fetch site summary for a language model | `curl -s https://aleth-project.com/llms.txt` | ## Measured capabilities **Status: Verified — values come from `data/capabilities.json`, produced by aleth's own measurement tools (`~/.aleth/competence.json`, `nucleus/eval_honesty.py`, training logs).** Two rules apply to this table and callers must respect them: 1. A capability marked **not measured** has no score. It is not zero, not low, not unknown- but-probably-fine. No number may be attributed to it. 2. Not every metric is a percentage. Perplexity (lower is better) and pixel error are not rescaled to 0–100; presenting them on a percentage bar would itself be a fabrication. | id | Category | Capability | Metric | Sample | Method | Measured | |---|---|---|---|---|---|---| | `durustluk` | DÜRÜSTLÜK | Uydurmayı reddetme | **76/76 adım** | 76 adım | nucleus/eval_honesty.py — dayanaksız soruda tahmin reddi | 2026-08-06 | | `gorme-kafa-siniri` | GÖRME | Kafa sınırını bulma | **%88.8** | 6 frames LOO | 6 frames LOO: mean 8.2px (rel 0.11) | 2026-08-02 | | `duyma-ogretilmis-ses` | DUYMA | Öğretilmiş sesleri tanıma | **%77.8** | 9 klip LOO | 9 klip LOO: %77 (3 ses) | — | | `gorme-kafa-dedektoru` | GÖRME | Kafa bulma | **%64.7** | 17 frames 3-fold | 17 frames 3-fold: good 64%, median 0.15 | — | | `gorme-goz` | GÖRME | Göz bulma | **%57.1** | 7 frames LOO | 7 frames LOO: hit(<10px) 57%, mean 42.9px | 2026-08-02 | | `dil-organi` | DİL | Dil organı (270M) | **ppl 43.60** | 3.72B token görüldü | doğrulama kümesi, epoch 93 (düşük iyidir) | 2026-08-06 | | `dil-ek-yapisi` | DİL | Türkçe ek yapısı | **not measured** | — | — | — | | `dil-cikarim` | DİL | Çıkarım zinciri | **not measured** | — | — | — | | `duyma-konusma` | DUYMA | Türkçe konuşma çözme (ASR) | **not measured** | — | — | — | 6 of 9 capabilities are measured. The remaining 3 are implemented but not yet evaluated against a frozen test set. ## Training data The corpus consumed by aleth's language organ is measured, and the portion whose licence permits redistribution is published. Sets that cannot be republished are listed with the reason rather than omitted. | id | Licence | Tokens | Share | Redistribution | Published | |---|---|---|---|---|---| | `cc100_tr` | CC-100 (CommonCrawl türevi; araştırma kullanımı) | 1885M | 16.6% | forbidden | no — licence forbids redistribution | | `hplt_tr` | CC0 1.0 (kaynak sayfaların kendi hakları sahiplerinde) | 7984M | 70.2% | free | no — source text deleted after encoding | | `wikipedia_tr` | CC BY-SA 4.0 | 272M | 2.4% | attribution | no — source text deleted after encoding | | `wikikaynak_tr` | CC BY-SA 4.0 | 3M | 0.0% | attribution | no — source text deleted after encoding | | `altyazi_cc` | CC BY (yalnız CC lisanslı videolar) | 2M | 0.0% | attribution | no — source text deleted after encoding | | `kod_oss_py` | MIT/BSD/Apache (yalnız izin veren lisanslı depolar) | 477M | 4.2% | notice-required | no — source text deleted after encoding | | `kod_pypi_py` | Apache/MIT (paket meta-verisinden doğrulanmış) | 632M | 5.6% | notice-required | no — source text deleted after encoding | | `kod_debian_py` | Expat/BSD/Apache (debian/copyright DEP-5 BEYANI — tahmin değil) | 123M | 1.1% | notice-required | no — source text deleted after encoding | Full catalogue, defect log and checksums: `https://aleth-project.com/api/v1/datasets.json` ## Links - Training data catalogue: https://aleth-project.com/api/v1/datasets.json - Site: https://aleth-project.com - Downloads: https://aleth-project.com/download - Capabilities and training data (human): https://aleth-project.com/training - Capability API: https://aleth-project.com/api/v1/capabilities.json - Release feed: https://aleth-project.com/api/v1/releases.json - Checksums: https://aleth-project.com/checksums.txt - Site summary for language models: https://aleth-project.com/llms.txt - Source repository: not public at time of writing - Container registry: none — aleth is not distributed as a container image - Implements: no upstream protocol; the federation protocol is project-specific --- Document conforms to the AI Docs Standard v1 (https://github.com/iwasoftcom/ai-docs-standard), CC BY 4.0. Generated 2026-08-08 for aleth 1.0.0.