Hugging Face's logo

YunusTAS13
/
ATLAS-AI

Text Generation
Transformers
GGUF
Turkish
turkish
qwen3
qlora
agent
tool-calling
llama.cpp
ollama
conversational
Model card Files
xet
 Community
YunusTAS13 commited on
Commit
67764ea
·
verified ·
1 Parent(s): 81c028b

Upload README.md with huggingface_hub

Browse files
Files changed (1) hide show
  1. README.md +178 -60
README.md CHANGED
@@ -1,98 +1,216 @@
1
- # Atlas
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2
 
3
- Atlas, [Qwen3-8B](https://huggingface.co/Qwen/Qwen3-8B) tabanlı, Türkçe odaklı, ince ayar (fine-tune) ile eğitilmiş bir dil modelidir. Tool calling (araç çağrısı) desteği sayesinde güvenli bir sandbox ortamında dosya ve terminal işlemleri yapabilen bir **agent** olarak kullanılabilir.
4
 
5
- ## Model Hakkında
6
 
7
- | Özellik | Değer |
8
- |---|---|
9
- | Taban Model | Qwen3-8B |
10
- | Eğitim Yöntemi | QLoRA (r=8, alpha=16) |
11
- | Eğitim Verisi | 9.689 örnek (Türkçe + kimlik + davranış + tool) |
12
- | Kuantizasyon | GGUF Q4_K_M |
13
- | Boyut | ~4.7 GB |
14
- | Lisans | GPL-3.0 (taban model: Apache-2.0) |
15
 
16
- ## Yetenekler
 
 
17
 
18
- - **Türkçe odaklı** konuşma ve bilgi
19
- - **Atlas kimliği** — kendini Atlas olarak tanıtır
20
- - Güvenli davranış — zararlı istekleri reddeder
21
- - **Tool calling** — dosya listeleme/okuma/yazma, klasör oluşturma, güvenli terminal komutları
22
 
23
- ## Kurulum
 
 
24
 
25
- ### 1. Model (Ollama)
26
 
27
  ```bash
28
- ollama create atlas -f Modelfile
 
 
 
 
 
 
 
29
  ```
30
 
31
- veya hazır GGUF dosyasını indirip:
32
 
33
  ```bash
34
- ollama create atlas -f Modelfile --from atlas-q4km.gguf
 
 
 
 
35
  ```
36
 
37
- ### 2. Agent Host
38
 
39
- ```bash
40
- # Bağımlılık yok, sadece Python 3.9+ ve çalışan Ollama gerekli
41
- python3 atlas_agent.py "çalışma klasöründeki dosyaları listele"
42
 
43
- # İnteraktif mod
44
- python3 atlas_agent.py -i
 
 
 
 
45
 
46
- # Komut onayı sormadan (dikkatli kullanın)
47
- python3 atlas_agent.py "notlar.txt oku" --no-confirm
48
- ```
49
 
50
- ## Güvenlik Sandboxı
51
 
52
  Agent host, modelin yalnızca `~/atlas-workspace` dizini içinde işlem yapmasına izin verir:
53
 
54
- - Sistem yolları yasaktır (`/etc`, `/usr`, `/bin`, `/boot`, `/proc`, `/sys`, `/dev`, `/var` vb.)
55
- - `sudo`/`su` ve root işlemleri engellenir
56
- - Tehlikeli komutlar engellenir (`rm -rf /`, `dd`, `mkfs`, `shutdown` vb.)
57
- - Tüm eylemler `~/atlas-workspace/audit.log` dosyasına yazılır
58
- - Yazma işlemleri ve komutlar kullanıcı onayına sunulur (`--no-confirm` ile kapatılabilir)
 
 
59
 
60
- ## Eğitim Verisi
61
 
62
- Eğitim verisi dört kaynaktan derlenmiştir:
63
 
64
- | Kaynak | Örnek Sayısı | Lisans |
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
65
  |---|---|---|
66
- | Elle yazılmış (kimlik + davranış + Türkçe) | 800 (80 × 10 tekrar) | Bizim |
67
- | [turkish-distilled-5K](https://huggingface.co/datasets/afkfatih/turkish-distilled-5K) | 5.660 | MIT |
68
- | [turkish-knowledge-sft](https://huggingface.co/datasets/Uunan/turkish-knowledge-sft) | 3.000 | Apache-2.0 |
69
- | Tool-calling örnekleri | 270 | Bizim |
70
 
71
- ## Eğitim
72
 
73
- Eğitim QLoRA yöntemiyle, 4-bit NF4 kuantizasyon ve LoRA adaptörleri kullanılarak iki turda yapılmıştır:
 
 
74
 
75
- **1. Tur** — kimlik, Türkçe ve davranış eğitimi (1.178 adım, loss ~0.96)
76
 
77
- **2. Tur** — tool-calling örnekleri eklenerek agent yeteneği (1.212 adım, loss ~0.83)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
78
 
79
- Detaylı konfigürasyon:
80
 
81
- - LoRA: r=8, alpha=16, dropout=0.05
82
- - Hedef modüller: q, k, v, o, gate, up, down projection
83
- - Optimizer: AdamW 8-bit
84
- - GPU: NVIDIA RTX 4050 (6 GB VRAM)
85
 
86
- ## Lisans
87
 
88
- Bu model **GPL-3.0** lisansıyla yayınlanmıştır.
89
 
90
- Taban model [Qwen3-8B](https://huggingface.co/Qwen/Qwen3-8B), **Apache License 2.0** ile lisanslanmıştır. Qwen3-8B, Alibaba Cloud tarafından geliştirilmiştir. Apache-2.0 lisans şartlarına uyulması zorunludur.
 
91
 
92
- Eğitim verisi olarak kullanılan açık kaynak veri setleri kendi lisanslarına (MIT, Apache-2.0) tabidir.
93
 
94
- ## Dosyalar
95
 
96
- - `atlas-q4km.gguf` — Q4_K_M kuantize model (Ollama uyumlu)
97
- - `Modelfile` — Ollama model tanımı
98
- - `atlas_agent.py` — Güvenli sandbox agent host uygulaması
 
1
+ ---
2
+ license: gpl-3.0
3
+ language:
4
+ - tr
5
+ base_model: Qwen/Qwen3-8B
6
+ pipeline_tag: text-generation
7
+ tags:
8
+ - turkish
9
+ - qwen3
10
+ - qlora
11
+ - gguf
12
+ - agent
13
+ - tool-calling
14
+ - llama.cpp
15
+ - ollama
16
+ metrics:
17
+ - perplexity
18
+ inference:
19
+ parameters:
20
+ temperature: 0.7
21
+ top_p: 0.9
22
+ model_type: auto
23
+ quantized_by: YunusTAS13
24
+ library_name: transformers
25
+ model-index:
26
+ - name: Atlas
27
+ results: []
28
+ ---
29
+
30
+ <div align="center">
31
+
32
+ # 🚀 Atlas
33
+
34
+ ### Türkçe Odaklı, Tool Calling Destekli, Güvenli Sandbox Agent Modeli
35
+
36
+ > Qwen3-8B tabanlı · QLoRA ile eğitilmiş · GGUF Q4_K_M · GPL-3.0
37
+
38
+ [![GitHub](https://img.shields.io/badge/GitHub-Repo-181717?style=for-the-badge&logo=github&logoColor=white)](https://github.com/YunusTAS13/atlas-model)
39
+ [![Release](https://img.shields.io/badge/Release-v2.0-blue?style=for-the-badge)](https://github.com/YunusTAS13/atlas-model/releases)
40
+ [![License](https://img.shields.io/badge/License-GPL--3.0-red.svg?style=for-the-badge)](LICENSE)
41
+ [![Ollama](https://img.shields.io/badge/Ollama-Uyumlu-00FF00?style=for-the-badge&logo=ollama)](https://ollama.com)
42
+ [![GGUF](https://img.shields.io/badge/GGUF-Q4_K_M-FF6F00?style=for-the-badge)](atlas-q4km.gguf)
43
+
44
+ ---
45
+
46
+ **Atlas**, tamamen sıfırdan geliştirdiğim, Türkçe odaklı bir yapay zeka modelidir.
47
+ Kendi kimliğine sahiptir, güvenli davranış sergiler ve sandbox ortamında **bilgisayarını kontrol edebilen** bir ajan olarak çalışır.
48
+
49
+ </div>
50
+
51
+ ---
52
+
53
+ ## 📥 Dosyalar
54
+
55
+ | Dosya | Boyut | Açıklama |
56
+ |---|---|---|
57
+ | [atlas-q4km.gguf](atlas-q4km.gguf) | ~4.7 GB | Q4_K_M kuantize GGUF (Ollama / llama.cpp uyumlu) |
58
+ | [Modelfile](Modelfile) | 113 B | Ollama model tanımı |
59
+ | [atlas_agent.py](atlas_agent.py) | 11.6 KB | Güvenli sandbox agent host uygulaması |
60
 
61
+ ---
62
 
63
+ ## 🚀 Kullanım
64
 
65
+ ### Ollama ile
 
 
 
 
 
 
 
66
 
67
+ ```bash
68
+ # GGUF dosyasını indir
69
+ wget https://huggingface.co/YunusTAS13/atlas-model/resolve/main/atlas-q4km.gguf
70
 
71
+ # Modeli oluştur
72
+ ollama create atlas -f Modelfile
 
 
73
 
74
+ # Sohbet
75
+ ollama run atlas "Merhaba, kendini tanıt"
76
+ ```
77
 
78
+ ### Agent Host ile
79
 
80
  ```bash
81
+ # Dosyaları listele
82
+ python3 atlas_agent.py "çalışma klasöründeki dosyaları listele"
83
+
84
+ # İnteraktif mod
85
+ python3 atlas_agent.py -i
86
+
87
+ # Çok adımlı görev
88
+ python3 atlas_agent.py "proje klasörü oluştur, içine not.md yaz, sonra oku"
89
  ```
90
 
91
+ ### llama.cpp ile (doğrudan)
92
 
93
  ```bash
94
+ ./llama-cli -m atlas-q4km.gguf \
95
+ -p "Merhaba" \
96
+ -c 8192 \
97
+ -n 512 \
98
+ --no-display-prompt
99
  ```
100
 
101
+ ---
102
 
103
+ ## ✨ Yetenekler
 
 
104
 
105
+ - 🇹🇷 **Türkçe uzmanlığı** — Türkçe konuşma, bilgi ve yazım üretimi
106
+ - 🪪 **Atlas kimliği** — kendini tanıtır, kişilik sahibidir
107
+ - 🛡️ **Güvenli davranış** — zararlı istekleri reddeder
108
+ - 🧰 **Tool calling** — dosya listeleme/okuma/yazma, klasör yönetimi, güvenli terminal komutları
109
+ - 🔒 **Sandbox güvenliği** — yalnızca `~/atlas-workspace` içinde çalışır
110
+ - 📝 **Audit log** — tüm eylemler kayıt altına alınır
111
 
112
+ ---
 
 
113
 
114
+ ## 🔐 Güvenlik Sandbox'ı
115
 
116
  Agent host, modelin yalnızca `~/atlas-workspace` dizini içinde işlem yapmasına izin verir:
117
 
118
+ - ❌ Sistem yolları engellenir: `/etc`, `/usr`, `/bin`, `/boot`, `/proc`, `/sys`, `/dev`, `/var`
119
+ - ❌ `sudo`/`su` ve root işlemleri engellenir
120
+ - ❌ Tehlikeli komutlar engellenir: `rm -rf /`, `dd`, `mkfs`, `shutdown` vb.
121
+ - ✅ Yazma işlemleri ve komutlar kullanıcı onayına sunulur
122
+ - 📝 Tüm eylemler `~/atlas-workspace/audit.log` dosyasına yazılır
123
+
124
+ ---
125
 
126
+ ## 🧠 Eğitim Detayları
127
 
128
+ ### Yöntem
129
 
130
+ QLoRA (Quantized Low-Rank Adaptation) ile iki aşamalı ince ayar:
131
+
132
+ | Tur | Amaç | Örnek | Adım | Son Loss |
133
+ |---|---|---|---|---|
134
+ | 1. Tur | Kimlik + Türkçe + Davranış | 9.419 | 1.178 | ~0.96 |
135
+ | 2. Tur | Tool Calling (agent) | 9.689 | 1.212 | ~0.83 |
136
+
137
+ ### Hiperparametreler
138
+
139
+ ```yaml
140
+ # LoRA
141
+ r: 8
142
+ lora_alpha: 16
143
+ lora_dropout: 0.05
144
+ target_modules: [q_proj, k_proj, v_proj, o_proj, gate_proj, up_proj, down_proj]
145
+
146
+ # Kuantizasyon
147
+ load_in_4bit: true
148
+ quant_type: nf4
149
+ compute_dtype: bfloat16
150
+
151
+ # Optimizasyon
152
+ optimizer: adamw_8bit
153
+ learning_rate: 2e-4
154
+ gradient_accumulation_steps: 8
155
+ batch_size: 1
156
+ max_length: 192
157
+ ```
158
+
159
+ ### Veri Kaynakları
160
+
161
+ | Kaynak | Örnek | Lisans |
162
  |---|---|---|
163
+ | ✍️ Elle yazılmış (kimlik + davranış + Türkçe) | 800 | Kişisel |
164
+ | 📚 [turkish-distilled-5K](https://huggingface.co/datasets/afkfatih/turkish-distilled-5K) | 5.660 | MIT |
165
+ | 📖 [turkish-knowledge-sft](https://huggingface.co/datasets/Uunan/turkish-knowledge-sft) | 3.000 | Apache-2.0 |
166
+ | 🧰 Tool calling örnekleri | 270 | Kişisel |
167
 
168
+ ### Donanım
169
 
170
+ - **GPU:** NVIDIA RTX 4050 (6 GB VRAM)
171
+ - **RAM:** 16 GB
172
+ - **Eğitim süresi:** ~8 saat toplam (2 tur)
173
 
174
+ ---
175
 
176
+ ## 📈 Kalite Göstergeleri
177
+
178
+ Bu model, sınırlı kaynaklarla (tek 6GB GPU) eğitilmiştir. Değerlendirme sonuçları:
179
+
180
+ | Test | Sonuç |
181
+ |---|---|
182
+ | Kimlik tanıtımı | ✅ "Ben Atlas'ım" |
183
+ | Türkçe bilgi soruları | ✅ Doğru yanıtlar |
184
+ | Zararlı istek reddi | ✅ Reddeder |
185
+ | Tool calling (listeleme/okuma/yazma) | ✅ Çalışıyor |
186
+ | Tehlikeli komut engelleme | ✅ Engelleniyor |
187
+
188
+ ---
189
+
190
+ ## 📄 Lisans ve Atıflar
191
+
192
+ **Atlas** **GPL-3.0** lisansı ile yayınlanmıştır.
193
+
194
+ | Bileşen | Kaynak | Lisans |
195
+ |---|---|---|
196
+ | Atlas (bu model) | **YunusTAS13** — tamamen sıfırdan geliştirildi | GPL-3.0 |
197
+ | Taban model | [Qwen3-8B](https://huggingface.co/Qwen/Qwen3-8B) (Alibaba Cloud) | Apache-2.0 |
198
+ | Eğitim verisi | [turkish-distilled-5K](https://huggingface.co/datasets/afkfatih/turkish-distilled-5K) | MIT |
199
+ | Eğitim verisi | [turkish-knowledge-sft](https://huggingface.co/datasets/Uunan/turkish-knowledge-sft) | Apache-2.0 |
200
 
201
+ > **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.
202
 
203
+ ---
 
 
 
204
 
205
+ <div align="center">
206
 
207
+ ### 🧠 Bu model, YunusTAS13 tarafından tamamen sıfırdan geliştirilmiş bir yapay zekadır.
208
 
209
+ Veri toplama, eğitim, model birleştirme, kuantizasyon, agent host yazılımı ve yayınlama süreçlerinin tamamı
210
+ kendi emeğiyle, ev ortamında tek bir NVIDIA RTX 4050 GPU üzerinde gerçekleştirilmiştir.
211
 
212
+ [💻 GitHub](https://github.com/YunusTAS13/atlas-model) · [🚀 Release v2.0](https://github.com/YunusTAS13/atlas-model/releases)
213
 
214
+ **© 2026 YunusTAS13 · GPL-3.0**
215
 
216
+ </div>