diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..9208be5 --- /dev/null +++ b/.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. diff --git a/.github/ISSUE_TEMPLATE/hata-bildir.yml b/.github/ISSUE_TEMPLATE/hata-bildir.yml new file mode 100644 index 0000000..3d5bd1f --- /dev/null +++ b/.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." diff --git a/.github/ISSUE_TEMPLATE/ozellik-istegi.yml b/.github/ISSUE_TEMPLATE/ozellik-istegi.yml new file mode 100644 index 0000000..48a26c2 --- /dev/null +++ b/.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 diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md new file mode 100644 index 0000000..17a9702 --- /dev/null +++ b/.github/pull_request_template.md @@ -0,0 +1,11 @@ +## Ne değişti? + + + +## Neden? + +## Kontrol listesi + +- [ ] Göreli linkler çalışıyor +- [ ] Bilgiler numexai.com.tr ile uyumlu +- [ ] Ekran görüntülerinde kişisel bilgi yok diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md new file mode 100644 index 0000000..7f5cd85 --- /dev/null +++ b/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. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..65844d8 --- /dev/null +++ b/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..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..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). diff --git a/README.en.md b/README.en.md new file mode 100644 index 0000000..9fbb749 --- /dev/null +++ b/README.en.md @@ -0,0 +1,174 @@ +
+ +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."** + +## ◆ 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) diff --git a/README.md b/README.md index e280b52..4a470cb 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,7 @@
+Numex — İnsanı önce koyan Türk yapay zekâsı + # ◆ 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 diff --git a/gorseller/numex-banner.png b/gorseller/numex-banner.png new file mode 100644 index 0000000..7fa817b Binary files /dev/null and b/gorseller/numex-banner.png differ diff --git a/gorseller/social-preview.png b/gorseller/social-preview.png new file mode 100644 index 0000000..3db7b17 Binary files /dev/null and b/gorseller/social-preview.png differ