numex_nedir/README.en.md

<div align="center">

<img src="gorseller/numex-banner.png" alt="Numex — the Turkish AI that puts people first" width="100%">

# ◆ Numex AI

## Türkiye's homegrown AI ecosystem

**Chat · Coding agent · CLI · API · Verified tests · Open-source app market · Git hosting · Encyclopedia**
Turkish-first by design — data stays in Türkiye, KVKK (Turkish GDPR) compliant.

[![Web](https://img.shields.io/badge/web-numexai.com.tr-1de9b6)](https://numexai.com.tr)
[![Founded](https://img.shields.io/badge/founded-2021%20·%20Istanbul-8b5cf6)](#-story)
[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)

🇹🇷 [Türkçe](README.md) · 🇬🇧 **English**

</div>

---

> *"Why is there no AI that speaks Turkish and understands Turkish culture?"*
> Numex started with that question in Istanbul in **2021**. Today it is a family of products running
> on a single brain — **"One mind, many doors. Not a tool — a companion."**

## ◆ At a glance

| | |
|---|---|
| **2021** | Founded in Istanbul by Nurullah Şahin |
| **16+** | Products in the Numex family |
| **5-stage** | Pipeline that turns every answer into natural Turkish |
| **128K** | Token context window |
| **44** | Open-source apps in Numex Market, all built autonomously |
| **28** | Articles in Numexpedia, a free Turkish encyclopedia |
| **2 × 256 GB** | RAM, dual-server infrastructure in Türkiye |
| **100,000** | Free API tokens on sign-up |

**One account, the whole family:** sign in once with Google or GitHub for the web app, CLI, Codex,
Hub and Forge.

## 🗺️ The Numex family

```mermaid
flowchart TB
    N["NUMEX · The Turkish AI that puts people first"]
    C["🔶 Core — the Brain · the mind behind everything; writes code and builds apps"]
    N --> C
    subgraph U["🟢 Apps · EVERYONE"]
      U1["💬 Numex — chat & assistant"]
      U2["🎓 Okul — verified tests"]
      U3["🧩 Codex — code editor"]
      U4["🛍️ Market — ready-made apps"]
    end
    subgraph G["🔶 Developer tools · DEVELOPERS"]
      G1["⌨️ CLI — from the terminal"]
      G2["🧰 SDK — embed in your app"]
      G3["🔌 API — connect remotely"]
    end
    subgraph P["🟢 Platform & Community"]
      P1["📦 Hub — discover & fork"]
      P2["🏗️ Forge — Git hosting"]
      P3["📖 Numexpedia — Turkish encyclopedia"]
      P4["🎮 Oyun Bahçesi — games for ages 7 to 70"]
    end
    C --> U
    C --> G
    C --> P
    subgraph A["🤝 From the same team"]
      A1["🧭 Pusulam — bookkeeping & POS"]
      A2["🩺 PC Doktoru — Windows maintenance"]
    end
```

| Product | For | What it does | Link |
|---|---|---|---|
| 💬 **Numex AI** | Everyone | Turkish chat, code, documents, web search, vision, voice, cultural characters, Agent mode | [numexai.com.tr](https://numexai.com.tr) |
| 🎓 **Numex Okul** | Students, parents, teachers | One AI writes each question, a second AI solves it independently; mismatches are discarded. LGS/TYT/AYT exam prep, driving test; solve on screen or export PDF | [okul.numexai.com.tr](https://okul.numexai.com.tr) |
| 🧩 **Numex Codex** | Developers | Turkish coding agent: browser editor, desktop IDE (v2.9.59, VS Code based), VS Code extension. Modes: Chat · Plan · Autonomous · Bug Hunter | [codex.numexai.com.tr](https://codex.numexai.com.tr) |
| 🛍️ **Numex Market** | Everyone | 44 free, open-source apps Numex built autonomously, in 7 categories — try live, read the source, fork | [market.numexai.com.tr](https://market.numexai.com.tr) |
| ⌨️ **Numex CLI** | Developers | Autonomous agent in the terminal (v3.3.10): plan mode, long-running missions, undo, offline via Ollama, remote-PC bridge, MCP | `npm i -g @numexai/cli` |
| 🧰 **Codex SDK** | Developers | chat · embeddings · images · models · search + a CLI Bridge to embed the agent anywhere | `npm i numexcodex-sdk` |
| 🔌 **Developer API** | Teams | REST v1 with `numex-pro`, `numex-fast`, `numex-think`, `numex-vision`, `numex-code`; streaming, function calling | [API docs](urunler/05-api-ve-sdk.md) |
| 📦 **Numex Hub** | Developers | AI that knows your repo: ask for a change, review it, apply → committed. Community showcase, trending repos, live feed | [hub.numexai.com.tr](https://hub.numexai.com.tr) |
| 🏗️ **Numex Forge** | Developers | Gitea-based Git server with a fully Turkish UI | [forge.numexai.com.tr](https://forge.numexai.com.tr) |
| 📖 **Numexpedia** | Everyone | Computing, AI and software explained in plain Turkish — free and open | [pedia.numexai.com.tr](https://pedia.numexai.com.tr) |
| 🧭 **Pusulam** | SMEs | Bookkeeping & point of sale | [pusulamx.com.tr](https://pusulamx.com.tr) |
| 🩺 **PC Doktoru** | Windows users | Portable AI maintenance, diagnosis and repair with autonomous mode and rollback | [pcdoktoru.com.tr](https://pcdoktoru.com.tr) |

## ⚡ What makes Numex different

**Not a raw API wrapper.** Numex wraps leading model providers with its own engines:

1. **Pipeline** — every request goes through 5 stages: prompt enrichment → model → Turkish correction
   & tone → quality check → answer. Stage 2A alone improved Turkish output quality by 30% in v3.1.
2. **Detective Mode™** — for critical questions, several models solve the same problem independently
   (fast, deep, alternative) and a referee picks the best answer *with its reasoning*.
   *"One model can be wrong. Three at once won't be."*
3. **Multi-Agent** — an orchestrator splits complex requests into sub-tasks for specialist agents and
   merges the result into one consistent answer.
4. **DeepView™** — multi-expert orchestration that produces a single *Master Plan* and shows how the
   AI thinks across 6 layers.
5. **Numex Core** — the agent engine behind Codex and the CLI: a 4-agent **Swarm Council**
   (Architect, Coder, Auditor, Designer), a **self-healing loop**, **Omni-Vision** (headless-browser
   DOM/3D checks), 3-tier inference (local ONNX WASM → Ollama → cloud), and **FinishGate**: a task
   cannot be marked "done" without live evidence — HTTP 200, passing tests, or DOM checks.

**Proof over claims** runs through the whole family: Detective Mode in chat, dual-AI verification
in Okul, FinishGate in code — and Numex Market, where 44 autonomously built, verified apps are open
for anyone to inspect.

## 🇹🇷 Cultural characters

Call them with `@`: **@FatmaAna** (cooking, home economics), **@MuhasebeciYunus** (tax, VAT,
e-invoicing), **@LokmanHekim** (healthy living), **@HaciBayramHoca** (spiritual questions),
**@Üstat**, **@Avukat**, **@Kod** and more. Each has its own domain and tone.

## 👩‍💻 For developers

```bash
npm i -g @numexai/cli
numex login
numex "build a dark-themed todo app"
numex plan "add a payment module"      # plan only, no edits
numex mission "make the tests pass"    # long-running autonomous mission
numex undo                             # roll back the last turn
```

```javascript
const { Numex } = require('numexcodex-sdk');
const numex = new Numex({ apiKey: process.env.NUMEX_API_KEY });
await numex.chat.completions.create({ messages: [{ role: 'user', content: 'Merhaba' }] });
```

📦 **Repos:** [numex-codex](https://github.com/mobilcep/numex-codex) · [numex-api](https://github.com/mobilcep/numex-api) · [numex-sdk](https://github.com/mobilcep/numex-sdk) (open source)

The agent keeps an open, readable **`.numex/`** folder in every project — RAG index, audit trail,
checkpoints, learned errors — so you can always see what it knows and what it did.

## 💳 Pricing

| Free | Starter PRO | Numex PRO ⭐ | Advanced |
|---|---|---|---|
| ₺0 · 15 msgs/day · 8K context | ₺99/mo · 50/day · 32K | ₺399/mo · unlimited · 128K · CLI + API | ₺599/mo · unlimited · 128K · 3 seats · custom characters |

Plus pay-as-you-go credits, non-renewing time passes (8 hours for ₺29), and guest use without sign-up.
Market, Numexpedia and Oyun Bahçesi are free. *See [numexai.com.tr](https://numexai.com.tr) for current prices.*

## 🔒 Privacy

Data is processed and stored in Türkiye (KVKK compliant) on a dual-server setup. In Codex and the
CLI the agent works on your own machine and asks before it acts; every change is shown as a diff,
logged, and reversible.

## 🏔️ Story

| Year | Milestone |
|---|---|
| 2021 | The first lines are written in the back room of a photography studio in Istanbul |
| 2023 | The Pipeline engine |
| 2024 | Detective Mode™ |
| 2025 | v3.0 rewrite, public API, characters, dual-server infrastructure; DeepView™ |
| 2026 | v3.1 public release; the Numex family: Codex, CLI, Okul, Market, Numexpedia, Hub & Forge |

The logo hides a secret: it reads as a modern AI symbol, but **turn it 180°** and it becomes the
8-pointed star of Seljuk architecture. *Two identities, one symbol.*
→ [Brand story](urunler/17-marka-kimligi.md)

> *"AI should support people, not replace them."* — Nurullah Şahin, founder

## 🤝 Contributing

This is Numex's open showcase and documentation repo. Fixes, translations, examples and articles are
welcome — see [CONTRIBUTING.md](CONTRIBUTING.md).

📧 destek@numexai.com.tr · 🌐 [numexai.com.tr](https://numexai.com.tr)