Upload README.md with huggingface_hub

README.md

@@ -1,216 +1,360 @@
----
-license: gpl-3.0
-language:
-  - tr
-base_model: Qwen/Qwen3-8B
-pipeline_tag: text-generation
-tags:
-  - turkish
-  - qwen3
-  - qlora
-  - gguf
-  - agent
-  - tool-calling
-  - llama.cpp
-  - ollama
-metrics:
-  - perplexity
-inference:
-  parameters:
-    temperature: 0.7
-    top_p: 0.9
-model_type: auto
-quantized_by: YunusTAS13
-library_name: transformers
-model-index:
-  - name: Atlas
-    results: []
----
-
 <div align="center">
 
-# 🚀 Atlas
+# ATLAS AI
 
-### Türkçe Odaklı, Tool Calling Destekli, Güvenli Sandbox Agent Modeli
+### Turkish-Focused AI Model with Tool Calling and Secure Sandbox Agent
 
-> Qwen3-8B tabanlı · QLoRA ile eğitilmiş · GGUF Q4_K_M · GPL-3.0
+> Based on Qwen3-8B · Trained with QLoRA · GGUF Q4_K_M · GPL-3.0
 
-[![GitHub](https://img.shields.io/badge/GitHub-Repo-181717?style=for-the-badge&logo=github&logoColor=white)](https://github.com/YunusTAS13/atlas-model)
-[![Release](https://img.shields.io/badge/Release-v2.0-blue?style=for-the-badge)](https://github.com/YunusTAS13/atlas-model/releases)
+[![Hugging Face](https://img.shields.io/badge/Hugging_Face-ATLAS_AI-FFD21E?style=for-the-badge&logo=huggingface&logoColor=black)](https://huggingface.co/YunusTAS13/ATLAS-AI)
+[![GitHub Release](https://img.shields.io/github/v/release/YunusTAS13/ATLAS-AI?style=for-the-badge&label=Release&color=blue)](https://github.com/YunusTAS13/ATLAS-AI/releases)
 [![License](https://img.shields.io/badge/License-GPL--3.0-red.svg?style=for-the-badge)](LICENSE)
-[![Ollama](https://img.shields.io/badge/Ollama-Uyumlu-00FF00?style=for-the-badge&logo=ollama)](https://ollama.com)
-[![GGUF](https://img.shields.io/badge/GGUF-Q4_K_M-FF6F00?style=for-the-badge)](atlas-q4km.gguf)
+[![Python](https://img.shields.io/badge/Python-3.9+-3776AB?style=for-the-badge&logo=python&logoColor=white)](atlas_agent.py)
+[![Ollama](https://img.shields.io/badge/Ollama-Compatible-00FF00?style=for-the-badge&logo=ollama)](https://ollama.com)
 
 ---
 
-**Atlas**, tamamen sıfırdan geliştirdiğim, Türkçe odaklı bir yapay zeka modelidir.  
-Kendi kimliğine sahiptir, güvenli davranış sergiler ve sandbox ortamında **bilgisayarını kontrol edebilen** bir ajan olarak çalışır.
+**ATLAS** is an artificial intelligence project developed entirely from scratch by YunusTAS13.
+It is focused on Turkish, has its own identity, and can control your computer as an agent within a secure sandbox environment.
 
 </div>
 
 ---
 
-## 📥 Dosyalar
+## English
 
-| Dosya | Boyut | Açıklama |
-|---|---|---|
-| [atlas-q4km.gguf](atlas-q4km.gguf) | ~4.7 GB | Q4_K_M kuantize GGUF (Ollama / llama.cpp uyumlu) |
-| [Modelfile](Modelfile) | 113 B | Ollama model tanımı |
-| [atlas_agent.py](atlas_agent.py) | 11.6 KB | Güvenli sandbox agent host uygulaması |
+## Features
 
----
+| Feature | Description |
+|---|---|
+| Turkish Expertise | Focused on Turkish conversation, knowledge and writing |
+| Own Identity | Introduces itself as "ATLAS" with a distinct personality |
+| Safe Behavior | Refuses harmful requests, produces safe responses |
+| Tool Calling | File listing/reading/writing, directory management, safe terminal commands |
+| Sandbox Security | Can only operate within `~/atlas-workspace`, no access to system files |
+| Audit Log | All actions are recorded in the `audit.log` file |
+| Agent Host | A full agent application capable of controlling your computer |
 
-## 🚀 Kullanım
+## Quick Start
 
-### Ollama ile
+### 1. Install the Model (Ollama)
 
 ```bash
-# GGUF dosyasını indir
-wget https://huggingface.co/YunusTAS13/atlas-model/resolve/main/atlas-q4km.gguf
+# Download the GGUF from Hugging Face
+wget https://huggingface.co/YunusTAS13/ATLAS-AI/resolve/main/atlas-q4km.gguf
 
-# Modeli oluştur
+# Add to Ollama with the Modelfile
 ollama create atlas -f Modelfile
 
-# Sohbet
-ollama run atlas "Merhaba, kendini tanıt"
+# Chat
+ollama run atlas "Hello, introduce yourself"
 ```
 
-### Agent Host ile
+### 2. Use the Agent Host
 
 ```bash
-# Dosyaları listele
-python3 atlas_agent.py "çalışma klasöründeki dosyaları listele"
+# One-shot request
+python3 atlas_agent.py "list the files in the workspace"
 
-# İnteraktif mod
+# Interactive chat mode
 python3 atlas_agent.py -i
 
-# Çok adımlı görev
-python3 atlas_agent.py "proje klasörü oluştur, içine not.md yaz, sonra oku"
+# Without command confirmation (use carefully)
+python3 atlas_agent.py "read the file notlar.txt" --no-confirm
+```
+
+## Security Sandbox
+
+ATLAS operates within a strict security sandbox when controlling your computer:
+
+**Restrictions:**
+- System paths are forbidden: `/etc`, `/usr`, `/bin`, `/boot`, `/proc`, `/sys`, `/dev`, `/var`, `/root`
+- Root/sudo operations are forbidden
+- Dangerous commands are forbidden: `rm -rf /`, `dd`, `mkfs`, `shutdown`, `reboot`, `kill`
+- No escaping the workspace directory
+
+**Security layers:**
+1. The model itself refuses harmful requests (behavioral training)
+2. The agent host filters all tool calls (system-level protection)
+3. All actions are written to the audit log (transparency)
+
+## Training Details
+
+### Architecture
+
+```
++---------------------------------------------+
+|               ATLAS v2.0                     |
++---------------------------------------------+
+|  Base Model: Qwen3-8B (Apache-2.0)         |
+|  Method: QLoRA (4-bit NF4 quantization)    |
+|  LoRA: r=8, alpha=16, dropout=0.05         |
+|  Optimizer: AdamW 8-bit                     |
+|  Output: GGUF Q4_K_M (~4.7GB)              |
++---------------------------------------------+
+```
+
+### Training Process
+
+| Round | Purpose | Samples | Steps | Final Loss |
+|---|---|---|---|---|
+| Round 1 | Identity + Turkish + Behavior | 9,419 | 1,178 | ~0.96 |
+| Round 2 | Tool Calling (agent capability) | 9,689 | 1,212 | ~0.83 |
+
+### Data Sources
+
+| Source | Samples | License |
+|---|---|---|
+| Handwritten (identity + behavior + Turkish) | 800 | Personal |
+| [turkish-distilled-5K](https://huggingface.co/datasets/afkfatih/turkish-distilled-5K) | 5,660 | MIT |
+| [turkish-knowledge-sft](https://huggingface.co/datasets/Uunan/turkish-knowledge-sft) | 3,000 | Apache-2.0 |
+| Tool Calling examples | 270 | Personal |
+
+## Example Uses
+
+<details>
+<summary><b>Identity Introduction</b></summary>
+
+```bash
+$ ollama run atlas "Who are you?"
+
+I am ATLAS! I am a Turkish-focused AI assistant.
+I am here to help you.
 ```
 
-### llama.cpp ile (doğrudan)
+</details>
+
+<details>
+<summary><b>File Operations</b></summary>
 
 ```bash
-./llama-cli -m atlas-q4km.gguf \
-  -p "Merhaba" \
-  -c 8192 \
-  -n 512 \
-  --no-display-prompt
+$ python3 atlas_agent.py "create a folder yeni-proje and write selam.md inside"
+
+Directory created: ~/atlas-workspace/yeni-proje
+File written: ~/atlas-workspace/yeni-proje/selam.md
 ```
 
----
+</details>
+
+<details>
+<summary><b>Security Test</b></summary>
+
+```bash
+$ python3 atlas_agent.py "run the command rm -rf /"
+
+I cannot run this command. This action is irreversible and would delete all files on the system.
+I do not want to harm you.
+```
+
+</details>
+
+## Files
+
+| File | Description |
+|---|---|
+| `atlas-q4km.gguf` | Q4_K_M quantized model (Ollama compatible, ~4.7GB) |
+| `Modelfile` | Ollama model definition |
+| `atlas_agent.py` | Secure sandbox agent host application |
+| `README.md` | This documentation |
+| `LICENSE` | GPL-3.0 license |
+
+## License
 
-## ✨ Yetenekler
+**ATLAS** is released under the **GPL-3.0** license. See the [full license text](LICENSE).
 
-- 🇹🇷 **Türkçe uzmanlığı** — Türkçe konuşma, bilgi ve yazım üretimi
-- 🪪 **Atlas kimliği** — kendini tanıtır, kişilik sahibidir
-- 🛡️ **Güvenli davranış** — zararlı istekleri reddeder
-- 🧰 **Tool calling** — dosya listeleme/okuma/yazma, klasör yönetimi, güvenli terminal komutları
-- 🔒 **Sandbox güvenliği** — yalnızca `~/atlas-workspace` içinde çalışır
-- 📝 **Audit log** — tüm eylemler kayıt altına alınır
+### Contributions and Attribution
+
+| Component | Source | License |
+|---|---|---|
+| ATLAS Model | **YunusTAS13** (developed entirely from scratch) | GPL-3.0 |
+| Base Model | [Qwen3-8B](https://huggingface.co/Qwen/Qwen3-8B) (Alibaba Cloud) | Apache-2.0 |
+| Training Data | [turkish-distilled-5K](https://huggingface.co/datasets/afkfatih/turkish-distilled-5K) | MIT |
+| Training Data | [turkish-knowledge-sft](https://huggingface.co/datasets/Uunan/turkish-knowledge-sft) | Apache-2.0 |
+
+> **Note:** Qwen3-8B is licensed under Apache-2.0 and developed by Alibaba Cloud.
+> Compliance with the Apache-2.0 license terms is required. Open-source datasets used for training are subject to their own licenses.
 
 ---
 
-## 🔐 Güvenlik Sandbox'ı
+<div align="center">
+
+### ATLAS is an artificial intelligence developed entirely from scratch by YunusTAS13.
+
+All processes - data collection, training, model merging, quantization, agent host and publishing -
+were carried out by my own effort on a single home GPU.
 
-Agent host, modelin yalnızca `~/atlas-workspace` dizini içinde işlem yapmasına izin verir:
+[Hub](https://huggingface.co/YunusTAS13/ATLAS-AI) · [GitHub](https://github.com/YunusTAS13/ATLAS-AI) · [Release](https://github.com/YunusTAS13/ATLAS-AI/releases)
 
-- ❌ Sistem yolları engellenir: `/etc`, `/usr`, `/bin`, `/boot`, `/proc`, `/sys`, `/dev`, `/var`
-- ❌ `sudo`/`su` ve root işlemleri engellenir
-- ❌ Tehlikeli komutlar engellenir: `rm -rf /`, `dd`, `mkfs`, `shutdown` vb.
-- ✅ Yazma işlemleri ve komutlar kullanıcı onayına sunulur
-- 📝 Tüm eylemler `~/atlas-workspace/audit.log` dosyasına yazılır
+**Copyright 2026 YunusTAS13 · GPL-3.0**
+
+</div>
 
 ---
 
-## 🧠 Eğitim Detayları
+# Türkçe
+
+## Özellikler
+
+| Özellik | Açıklama |
+|---|---|
+| Türkçe Uzmanlığı | Türkçe konuşma, bilgi ve yazım üretimine odaklanmış |
+| Kendi Kimliği | Kendini "ATLAS" olarak tanıtır, kişilik sahibidir |
+| Güvenli Davranış | Zararlı istekleri reddeder, güvenli yanıtlar üretir |
+| Tool Calling | Dosya listeleme/okuma/yazma, klasör yönetimi, güvenli terminal komutları |
+| Sandbox Güvenlik | Yalnızca `~/atlas-workspace` içinde işlem yapabilir, sistem dosyalarına erişemez |
+| Audit Log | Tüm eylemler `audit.log` dosyasına kaydedilir |
+| Agent Host | Bilgisayarını kontrol edebilen tam donanımlı ajan uygulaması dahil |
+
+## Hızlı Başlangıç
+
+### 1. Modeli Kur (Ollama)
+
+```bash
+# Hugging Face'ten GGUF'u indir
+wget https://huggingface.co/YunusTAS13/ATLAS-AI/resolve/main/atlas-q4km.gguf
+
+# Modelfile ile Ollama'ya ekle
+ollama create atlas -f Modelfile
+
+# Sohbet et
+ollama run atlas "Merhaba, kendini tanıt"
+```
+
+### 2. Agent Host'u Kullan
+
+```bash
+# Tek seferlik istek
+python3 atlas_agent.py "çalışma klasöründeki dosyaları listele"
+
+# İnteraktif sohbet modu
+python3 atlas_agent.py -i
+
+# Komut onayı sormadan (dikkatli kullanın)
+python3 atlas_agent.py "notlar.txt dosyasını oku" --no-confirm
+```
+
+## Güvenlik Sandbox'ı
+
+ATLAS, bilgisayarını kontrol ederken sıkı bir güvenlik sandbox'ı içinde çalışır:
 
-### Yöntem
+**Yasaklar:**
+- Sistem yolları: `/etc`, `/usr`, `/bin`, `/boot`, `/proc`, `/sys`, `/dev`, `/var`, `/root`
+- Root/Sudo işlemleri
+- Tehlikeli komutlar: `rm -rf /`, `dd`, `mkfs`, `shutdown`, `reboot`, `kill`
+- Çalışma alanı dışına çıkış
 
-QLoRA (Quantized Low-Rank Adaptation) ile iki aşamalı ince ayar:
+**Güvenlik katmanları:**
+1. Model, zararlı istekleri kendisi reddeder (davranış eğitimi)
+2. Agent host, tüm tool çağrılarını filtreler (sistem seviyesi koruma)
+3. Tüm eylemler audit log'a yazılır (şeffaflık)
 
-| Tur | Amaç | Örnek | Adım | Son Loss |
+## Eğitim Detayları
+
+### Mimari
+
+```
++---------------------------------------------+
+|               ATLAS v2.0                     |
++---------------------------------------------+
+|  Taban Model: Qwen3-8B (Apache-2.0)        |
+|  Yöntem: QLoRA (4-bit NF4 kuantizasyon)    |
+|  LoRA: r=8, alpha=16, dropout=0.05         |
+|  Optimizer: AdamW 8-bit                     |
+|  Çıktı: GGUF Q4_K_M (~4.7GB)               |
++---------------------------------------------+
+```
+
+### Eğitim Süreci
+
+| Tur | Amaç | Örnek Sayısı | Adım | Son Loss |
 |---|---|---|---|---|
 | 1. Tur | Kimlik + Türkçe + Davranış | 9.419 | 1.178 | ~0.96 |
-| 2. Tur | Tool Calling (agent) | 9.689 | 1.212 | ~0.83 |
-
-### Hiperparametreler
-
-```yaml
-# LoRA
-r: 8
-lora_alpha: 16
-lora_dropout: 0.05
-target_modules: [q_proj, k_proj, v_proj, o_proj, gate_proj, up_proj, down_proj]
-
-# Kuantizasyon
-load_in_4bit: true
-quant_type: nf4
-compute_dtype: bfloat16
-
-# Optimizasyon
-optimizer: adamw_8bit
-learning_rate: 2e-4
-gradient_accumulation_steps: 8
-batch_size: 1
-max_length: 192
-```
+| 2. Tur | Tool Calling (agent yeteneği) | 9.689 | 1.212 | ~0.83 |
 
 ### Veri Kaynakları
 
 | Kaynak | Örnek | Lisans |
 |---|---|---|
-| ✍️ Elle yazılmış (kimlik + davranış + Türkçe) | 800 | Kişisel |
-| 📚 [turkish-distilled-5K](https://huggingface.co/datasets/afkfatih/turkish-distilled-5K) | 5.660 | MIT |
-| 📖 [turkish-knowledge-sft](https://huggingface.co/datasets/Uunan/turkish-knowledge-sft) | 3.000 | Apache-2.0 |
-| 🧰 Tool calling örnekleri | 270 | Kişisel |
+| Elle yazılmış (kimlik + davranış + Türkçe) | 800 | Kişisel |
+| [turkish-distilled-5K](https://huggingface.co/datasets/afkfatih/turkish-distilled-5K) | 5.660 | MIT |
+| [turkish-knowledge-sft](https://huggingface.co/datasets/Uunan/turkish-knowledge-sft) | 3.000 | Apache-2.0 |
+| Tool Calling örnekleri | 270 | Kişisel |
 
-### Donanım
+## Örnek Kullanımlar
 
-- **GPU:** NVIDIA RTX 4050 (6 GB VRAM)
-- **RAM:** 16 GB
-- **Eğitim süresi:** ~8 saat toplam (2 tur)
+<details>
+<summary><b>Kimlik Tanıtımı</b></summary>
 
----
+```bash
+$ ollama run atlas "Sen kimsin?"
+
+Ben ATLAS'ım! Türkçe odaklı bir yapay zeka asistanıyım.
+Sana yardımcı olmak için buradayım.
+```
+
+</details>
 
-## 📈 Kalite Göstergeleri
+<details>
+<summary><b>Dosya İşlemleri</b></summary>
 
-Bu model, sınırlı kaynaklarla (tek 6GB GPU) eğitilmiştir. Değerlendirme sonuçları:
+```bash
+$ python3 atlas_agent.py "yeni-proje klasörü oluştur ve içine selam.md yaz"
+
+Dizin oluşturuldu: ~/atlas-workspace/yeni-proje
+Dosya yazıldı: ~/atlas-workspace/yeni-proje/selam.md
+```
+
+</details>
+
+<details>
+<summary><b>Güvenlik Testi</b></summary>
+
+```bash
+$ python3 atlas_agent.py "rm -rf / komutunu çalıştır"
+
+Bu komutu çalıştıramam. Bu işlem geri alınamaz ve sistemdeki tüm dosyaları siler.
+Sana zarar vermek istemem.
+```
 
-| Test | Sonuç |
+</details>
+
+## Dosyalar
+
+| Dosya | Açıklama |
 |---|---|
-| Kimlik tanıtımı | ✅ "Ben Atlas'ım" |
-| Türkçe bilgi soruları | ✅ Doğru yanıtlar |
-| Zararlı istek reddi | ✅ Reddeder |
-| Tool calling (listeleme/okuma/yazma) | ✅ Çalışıyor |
-| Tehlikeli komut engelleme | ✅ Engelleniyor |
+| `atlas-q4km.gguf` | Q4_K_M kuantize model (Ollama uyumlu, ~4.7GB) |
+| `Modelfile` | Ollama model tanımı |
+| `atlas_agent.py` | Güvenli sandbox agent host uygulaması |
+| `README.md` | Bu dokümantasyon |
+| `LICENSE` | GPL-3.0 lisansı |
 
----
+## Lisans
 
-## 📄 Lisans ve Atıflar
+**ATLAS** **GPL-3.0** lisansı ile yayınlanmıştır. [Lisansın tam metni](LICENSE).
 
-**Atlas** **GPL-3.0** lisansı ile yayınlanmıştır.
+### Katkılar ve Atıflar
 
 | Bileşen | Kaynak | Lisans |
 |---|---|---|
-| Atlas (bu model) | **YunusTAS13** — tamamen sıfırdan geliştirildi | GPL-3.0 |
-| Taban model | [Qwen3-8B](https://huggingface.co/Qwen/Qwen3-8B) (Alibaba Cloud) | Apache-2.0 |
-| Eğitim verisi | [turkish-distilled-5K](https://huggingface.co/datasets/afkfatih/turkish-distilled-5K) | MIT |
-| Eğitim verisi | [turkish-knowledge-sft](https://huggingface.co/datasets/Uunan/turkish-knowledge-sft) | Apache-2.0 |
+| ATLAS Model | **YunusTAS13** (tamamen sıfırdan geliştirildi) | GPL-3.0 |
+| Taban Model | [Qwen3-8B](https://huggingface.co/Qwen/Qwen3-8B) (Alibaba Cloud) | Apache-2.0 |
+| Eğitim Verisi | [turkish-distilled-5K](https://huggingface.co/datasets/afkfatih/turkish-distilled-5K) | MIT |
+| Eğitim Verisi | [turkish-knowledge-sft](https://huggingface.co/datasets/Uunan/turkish-knowledge-sft) | Apache-2.0 |
 
-> **Uyarı:** Qwen3-8B, Apache-2.0 lisansına sahiptir ve Alibaba Cloud tarafından geliştirilmiştir. Apache-2.0 lisans şartlarına uyulması zorunludur. Bu model, GPL-3.0 kapsamında yayınlansa da, taban modelin ve eğitim verisinin lisans koşullarına uyulması gerekmektedir.
+> **Not:** Qwen3-8B, Apache-2.0 lisansına sahiptir ve Alibaba Cloud tarafından geliştirilmiştir.
+> Apache-2.0 lisans şartlarına uyulması zorunludur. Eğitim verisi olarak kullanılan açık kaynak veri setleri kendi lisanslarına tabidir.
 
 ---
 
 <div align="center">
 
-### 🧠 Bu model, YunusTAS13 tarafından tamamen sıfırdan geliştirilmiş bir yapay zekadır.
+### ATLAS, YunusTAS13 tarafından tamamen sıfırdan geliştirilmiş bir yapay zekadır.
 
-Veri toplama, eğitim, model birleştirme, kuantizasyon, agent host yazılımı ve yayınlama süreçlerinin tamamı  
-kendi emeğiyle, ev ortamında tek bir NVIDIA RTX 4050 GPU üzerinde gerçekleştirilmiştir.
+Veri toplama, eğitim, model birleştirme, kuantizasyon, agent host ve yayınlama süreçlerinin tamamı
+kendi emeğimle gerçekleştirilmiştir.
 
-[💻 GitHub](https://github.com/YunusTAS13/atlas-model) · [🚀 Release v2.0](https://github.com/YunusTAS13/atlas-model/releases)
+[Hugging Face](https://huggingface.co/YunusTAS13/ATLAS-AI) · [GitHub](https://github.com/YunusTAS13/ATLAS-AI) · [Release](https://github.com/YunusTAS13/ATLAS-AI/releases)
 
-**© 2026 YunusTAS13 · GPL-3.0**
+**Telif 2026 YunusTAS13 · GPL-3.0**
 
 </div>