Ingilizce README, katki rehberi, davranis kurallari, issue sablonlari ve paylasim gorseli

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: true
+contact_links:
+  - name: 🌐 Numex AI
+    url: https://numexai.com.tr
+    about: Ürünleri dene, planları incele.
+  - name: 📖 Numexpedia
+    url: https://pedia.numexai.com.tr
+    about: Numex ve yapay zekâ hakkında Türkçe makaleler.
+  - name: 🔒 Güvenlik bildirimi
+    url: mailto:destek@numexai.com.tr
+    about: Güvenlik açıklarını lütfen herkese açık issue yerine e-postayla bildir.

.github/ISSUE_TEMPLATE/hata-bildir.yml

@@ -0,0 +1,54 @@
+name: 🐞 Hata bildir
+description: Bir Numex ürününde veya bu dokümanda hata bildir
+labels: ["hata"]
+body:
+  - type: dropdown
+    id: urun
+    attributes:
+      label: Hangi ürün?
+      options:
+        - Numex AI (web sohbet)
+        - Numex Codex (web / IDE / VS Code)
+        - Numex CLI
+        - Codex SDK / API
+        - Numex Okul
+        - Numex Market
+        - Numex Hub / Forge
+        - Numexpedia
+        - PC Doktoru
+        - Pusulam
+        - Bu doküman deposu
+    validations:
+      required: true
+  - type: textarea
+    id: ne-oldu
+    attributes:
+      label: Ne oldu?
+      description: Hatayı kısaca anlat.
+    validations:
+      required: true
+  - type: textarea
+    id: adimlar
+    attributes:
+      label: Nasıl tekrarlanır?
+      placeholder: |
+        1. ...
+        2. ...
+        3. Hata görünür
+  - type: textarea
+    id: beklenen
+    attributes:
+      label: Ne bekliyordun?
+  - type: input
+    id: surum
+    attributes:
+      label: Sürüm / ortam
+      placeholder: "ör. Codex IDE v2.9.59, Windows 11 · CLI v3.3.10 · Chrome 130"
+  - type: textarea
+    id: ekran
+    attributes:
+      label: Ekran görüntüsü / log
+      description: E-posta, token, API anahtarı gibi kişisel bilgileri gizlemeyi unutma.
+  - type: markdown
+    attributes:
+      value: "🔒 **Güvenlik açığı mı?** Lütfen issue açma, destek@numexai.com.tr adresine yaz."

.github/ISSUE_TEMPLATE/ozellik-istegi.yml

@@ -0,0 +1,26 @@
+name: 💡 Özellik isteği
+description: Numex ailesi için yeni bir fikir öner
+labels: ["öneri"]
+body:
+  - type: input
+    id: urun
+    attributes:
+      label: Hangi ürün için?
+      placeholder: "ör. Codex, Okul, Market, CLI…"
+  - type: textarea
+    id: sorun
+    attributes:
+      label: Hangi sorunu çözüyor?
+      description: "\"… yaparken … zorlanıyorum\" gibi."
+    validations:
+      required: true
+  - type: textarea
+    id: oneri
+    attributes:
+      label: Önerin
+    validations:
+      required: true
+  - type: textarea
+    id: alternatif
+    attributes:
+      label: Denediğin alternatifler

.github/pull_request_template.md

@@ -0,0 +1,11 @@
+## Ne değişti?
+
+<!-- Kısaca anlat -->
+
+## Neden?
+
+## Kontrol listesi
+
+- [ ] Göreli linkler çalışıyor
+- [ ] Bilgiler numexai.com.tr ile uyumlu
+- [ ] Ekran görüntülerinde kişisel bilgi yok

CODE_OF_CONDUCT.md

@@ -0,0 +1,42 @@
+# 🤝 Davranış Kuralları
+
+*Numex'in ilkesi: "İnsanı önce koyan Türk yapay zekâsı." Topluluğumuzda da insan önce gelir.*
+
+## Taahhüdümüz
+
+Numex topluluğunu; yaş, beden, engellilik, etnik köken, cinsiyet kimliği ve ifadesi, deneyim düzeyi,
+eğitim, sosyoekonomik durum, uyruk, görünüş, ırk, din veya cinsel yönelim fark etmeksizin herkes için
+**taciz içermeyen, kapsayıcı ve saygılı** bir ortam yapmayı taahhüt ediyoruz.
+
+## Beklenen davranışlar
+
+- Farklı görüşlere ve deneyimlere saygı göstermek
+- Yapıcı eleştiri vermek ve almak
+- Hatayı kabul etmek, özür dilemek ve ondan öğrenmek
+- Topluluğun iyiliğine odaklanmak
+- Yeni gelenlere sabırla yardım etmek — *"yoldaş"* olmak
+
+## Kabul edilmeyen davranışlar
+
+- Cinsel içerikli dil veya görseller, istenmeyen yaklaşımlar
+- Hakaret, aşağılama, kişisel veya siyasi saldırılar, trolleme
+- Herkese açık ya da özel taciz
+- Başkalarının kişisel bilgilerini (adres, e-posta vb.) izinsiz paylaşmak
+- Profesyonel bir ortamda uygunsuz sayılabilecek diğer davranışlar
+
+## Uygulama
+
+Kural ihlallerini **destek@numexai.com.tr** adresine bildirebilirsin. Tüm bildirimler incelenir ve
+gizli tutulur. Proje yöneticileri; uyarı, geçici veya kalıcı uzaklaştırma gibi uygun gördükleri
+önlemleri alma hakkına sahiptir.
+
+## Kaynak
+
+Bu metin [Contributor Covenant](https://www.contributor-covenant.org) 2.1 sürümünden uyarlanmıştır.
+
+---
+
+**🇬🇧 English:** We pledge a harassment-free, inclusive community for everyone. Be respectful, give
+and accept constructive feedback, help newcomers. Harassment, insults, sexualized content and
+doxxing are not tolerated. Report issues to **destek@numexai.com.tr**. Adapted from the Contributor
+Covenant 2.1.

CONTRIBUTING.md

@@ -0,0 +1,53 @@
+# 🤝 Katkı Rehberi
+
+Numex'in tanıtım ve dokümantasyon deposuna katkı vermek istediğin için teşekkürler! 🇹🇷
+*(English below.)*
+
+## Neler kabul ediyoruz?
+
+| Katkı | Örnek |
+|---|---|
+| ✏️ **Düzeltme** | Yazım hatası, bozuk link, eski bilgi |
+| 🌍 **Çeviri** | `README.en.md`'yi geliştirmek, yeni dil eklemek (`README.<dil>.md`) |
+| 📚 **Makale** | `makaleler/` altına Numex kullanım deneyimi, rehber, karşılaştırma |
+| 💡 **Örnek** | Numex CLI / SDK / API ile yaptığın bir projenin anlatımı |
+| 🖼️ **Görsel** | Güncel ekran görüntüleri (`gorseller/`, kişisel bilgiler gizlenmiş olmalı) |
+
+Ürünlerdeki **hata ve istekler** için lütfen *Hata bildir* veya *Özellik isteği* şablonuyla bir
+[issue](../../issues/new/choose) aç.
+
+## Nasıl katkı verilir?
+
+1. Depoyu **fork**'la (çatalla).
+2. Yeni bir dal aç: `git checkout -b duzeltme/codex-sayfasi`
+3. Değişikliğini yap. Markdown'da mevcut sayfaların yapısına ve üslubuna uy.
+4. Göreli linklerin çalıştığını kontrol et.
+5. Açıklayıcı bir commit mesajı yaz: `Codex sayfasına kısayol tablosu ekle`
+6. **Pull Request** aç; ne değiştiğini ve nedenini kısaca yaz.
+
+## Yazım kuralları
+
+- **Dil:** Türkçe metinlerde sade, günlük Türkçe (*"yapılmaktadır"* değil *"yapılır"*).
+- **Doğruluk:** Rakamlar ve özellikler numexai.com.tr'deki güncel bilgilerle uyumlu olmalı. Emin
+  olmadığın iddiayı ekleme.
+- **Gizlilik:** Ekran görüntülerinde e-posta, token, cihaz kimliği, API anahtarı gibi bilgileri gizle.
+- **Görseller:** PNG, genişlik en fazla 1600 px.
+
+## Davranış
+
+Tüm katkılar [Davranış Kuralları](CODE_OF_CONDUCT.md)'na tabidir.
+
+## Güvenlik
+
+Numex ürünlerinde bir **güvenlik açığı** bulduysan herkese açık issue açma; doğrudan
+**destek@numexai.com.tr** adresine yaz.
+
+---
+
+## 🇬🇧 English
+
+Thanks for helping! We welcome fixes, translations (`README.<lang>.md`), articles in `makaleler/`,
+usage examples and up-to-date screenshots (with personal data hidden). Fork → branch → change →
+pull request. For product bugs and feature requests, open an [issue](../../issues/new/choose).
+Report security issues privately to **destek@numexai.com.tr**. All contributions follow our
+[Code of Conduct](CODE_OF_CONDUCT.md).

README.en.md

@@ -0,0 +1,174 @@
+<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' }] });
+```
+
+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)

README.md

@@ -1,5 +1,7 @@
 <div align="center">
 
+<img src="gorseller/numex-banner.png" alt="Numex — İnsanı önce koyan Türk yapay zekâsı" width="100%">
+
 # ◆ Numex AI
 
 ## Türkiye'nin yerli yapay zeka ekosistemi
@@ -14,6 +16,8 @@ Türkçe'ye ve Türk kullanıcısına özel — verileri Türkiye'de, KVKK uyuml
 [![API](https://img.shields.io/badge/API-v1-f59e0b)](urunler/05-api-ve-sdk.md)
 [![Lisans](https://img.shields.io/badge/lisans-MIT-blue)](LICENSE)
 
+🇹🇷 **Türkçe** · 🇬🇧 [English](README.en.md)
+
 [🚀 Ücretsiz başla](https://numexai.com.tr) ·
 [🧩 Ürünler](urunler/) ·
 [👨‍👩‍👧‍👦 Aile](urunler/15-numex-ailesi.md) · [🏗️ Mimari](docs/mimari.md) ·
@@ -331,8 +335,8 @@ Fotoğrafçılık'ın kurucusu.
 ## 🤝 Katkı
 
 Bu depo Numex AI'ın **açık tanıtım ve dokümantasyon** deposudur. Yazım düzeltmeleri, çeviriler,
-kullanım örnekleri ve yeni makaleler için Pull Request açabilirsiniz. Soru ve önerileriniz için
-[Issues](../../issues).
+kullanım örnekleri ve yeni makaleler için Pull Request açabilirsiniz → [CONTRIBUTING.md](CONTRIBUTING.md) ·
+[Davranış Kuralları](CODE_OF_CONDUCT.md). Soru ve önerileriniz için [Issues](../../issues).
 
 ## 📬 İletişim