Numex — the Turkish AI that puts people first

# ◆ 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**

--- > *"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."** ## ✨ Showcase

💬 Numex AI — Turkish chat, code, documents, search, characters, Detective Mode™ numexai.com.tr · details	🎓 Numex Okul — one AI writes each question, a second AI verifies it; exam prep okul.numexai.com.tr · details
🛍️ Numex Market — 44 free, open-source apps Numex built by itself market.numexai.com.tr · details	📖 Numexpedia — computing and AI explained in plain Turkish; 28 articles pedia.numexai.com.tr · details

**For developers:** 🧩 [Codex](https://github.com/mobilcep/numex-codex) · 🔌 [API](https://github.com/mobilcep/numex-api) · 🧰 [SDK](https://github.com/mobilcep/numex-sdk) · 📦 [Hub](https://hub.numexai.com.tr) · 🏗️ [Forge](https://forge.numexai.com.tr) ## ◆ 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](https://pusulamx.com) | | 🩺 **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)