Upload README.md with huggingface_hub
Browse files
README.md
ADDED
|
@@ -0,0 +1,101 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# Nova AI — Arquitectura Híbrida Oficial (ModernoTech)
|
| 2 |
+
|
| 3 |
+
[](LICENSE)
|
| 4 |
+
[](docs/NOVA_GGUF_SPEC.md)
|
| 5 |
+
[](#arquitectura-técnica)
|
| 6 |
+
[](#especificaciones-técnicas)
|
| 7 |
+
|
| 8 |
+
**Nova AI** es una inteligencia artificial conversacional e híbrida desarrollada por **ModernoTech**, concebida para ser **ultrapotente en relación con su tamaño, ultracompacta, ultraligera y con arquitectura de auto-mejora continua**.
|
| 9 |
+
|
| 10 |
+
---
|
| 11 |
+
|
| 12 |
+
## 💡 Concepto Fundamental
|
| 13 |
+
|
| 14 |
+
Nova AI rompe la dependencia absoluta de los LLMs gigantes. En su lugar, distribuye la inteligencia en tres pilares:
|
| 15 |
+
|
| 16 |
+
```text
|
| 17 |
+
NOVA AI
|
| 18 |
+
│
|
| 19 |
+
┌────────────────┴────────────────┐
|
| 20 |
+
▼ ▼
|
| 21 |
+
[ NOVA NATIVE ] [ NOVA 2B LLM ]
|
| 22 |
+
100% Integer & Ternary {-1,0,1} Inferencia GGUF Universal
|
| 23 |
+
│ (LM Studio, Ollama, llama.cpp)
|
| 24 |
+
┌──────────────┼──────────────┐
|
| 25 |
+
▼ ▼ ▼
|
| 26 |
+
[MoCE Experts] [User Memory] [Nova RAG FTS5]
|
| 27 |
+
│
|
| 28 |
+
▼
|
| 29 |
+
[Self-Improvement Engine]
|
| 30 |
+
```
|
| 31 |
+
|
| 32 |
+
1. **Nova Native (100% Entero y Ternario):** Computación en pesos ternarios empaquetados (2 bits por peso) con acumuladores `Int32` y activaciones `Int16`. Cero uso de `float` en operaciones críticas.
|
| 33 |
+
2. **Mixture of Code-Experts (MoCE):** Expertos modulares en Python con conocimiento estructurado persistente en SQLite (`storage/knowledge.db`):
|
| 34 |
+
- **`CodeExpert`**: HTML5, CSS3, JavaScript, Python.
|
| 35 |
+
- **`LanguagesExpert`**: Chino Mandarín, Inglés, Francés, Portugués, Español.
|
| 36 |
+
- **`MathExpert`**: Álgebra lineal, cálculo, probabilidad y lógica.
|
| 37 |
+
3. **RAG Ultraligero SQLite FTS5:** Búsqueda léxica con ranking BM25 sin necesidad de bases vectoriales pesadas.
|
| 38 |
+
4. **Self-Improvement Engine:** Detecta debilidades, autopsia de errores, genera ejercicios sintéticos de práctica, verifica resultados y consolida mejoras en disco de forma autónoma.
|
| 39 |
+
5. **Nova 2B LLM (GGUF):** Actúa como motor de razonamiento de respaldo y profesor para sintetizar conocimiento nuevo.
|
| 40 |
+
|
| 41 |
+
---
|
| 42 |
+
|
| 43 |
+
## 🚀 Despliegue Rápido
|
| 44 |
+
|
| 45 |
+
### Opción 1: Modelo GGUF Universal (LM Studio / Ollama / llama.cpp)
|
| 46 |
+
El archivo `nova-2b.gguf` puede ejecutarse directamente en cualquier cliente compatible con GGUF:
|
| 47 |
+
- **LM Studio:** Importar `nova-2b.gguf` y cargar el preset [model_preset.json](model_preset.json).
|
| 48 |
+
- **Ollama:**
|
| 49 |
+
```bash
|
| 50 |
+
ollama create nova-2b -f Modelfile
|
| 51 |
+
ollama run nova-2b
|
| 52 |
+
```
|
| 53 |
+
- **llama.cpp:**
|
| 54 |
+
```bash
|
| 55 |
+
./llama-server -m nova-2b.gguf -c 1048576 --temp 0.8 --top-p 0.95
|
| 56 |
+
```
|
| 57 |
+
|
| 58 |
+
### Opción 2: Nova AI Framework Completo (MoCE + RAG + Auto-Mejora)
|
| 59 |
+
Ejecuta la consola interactiva con todas las capas activadas:
|
| 60 |
+
```bash
|
| 61 |
+
python3 nova_core.py
|
| 62 |
+
```
|
| 63 |
+
- Escribe preguntas técnicas o habla cotidianamente.
|
| 64 |
+
- Para enseñar: `Aprende esto: <hecho nuevo>`
|
| 65 |
+
- Para forzar auto-mejora: `/improve`
|
| 66 |
+
- Para ver rendimiento por habilidad: `/skills`
|
| 67 |
+
- Para ver estadísticas: `/stats`
|
| 68 |
+
|
| 69 |
+
### Opción 3: Servidor API Compatible con OpenAI
|
| 70 |
+
Levanta el endpoint HTTP local en el puerto 8080:
|
| 71 |
+
```bash
|
| 72 |
+
python3 nova_server.py
|
| 73 |
+
```
|
| 74 |
+
- **Endpoint:** `http://127.0.0.1:8080/v1/chat/completions` (compatible con Open WebUI, Cursor, VS Code).
|
| 75 |
+
- **Estado:** `http://127.0.0.1:8080/status`
|
| 76 |
+
|
| 77 |
+
---
|
| 78 |
+
|
| 79 |
+
## 🧪 Auditorías y Pruebas Unitarias
|
| 80 |
+
|
| 81 |
+
Nova AI cuenta con un riguroso sistema de pruebas y auditoría automática:
|
| 82 |
+
|
| 83 |
+
```bash
|
| 84 |
+
# 1. Auditoría estricta Integer-Only / Ternary (falla si detecta float):
|
| 85 |
+
python3 nova_auditor.py
|
| 86 |
+
|
| 87 |
+
# 2. Suite de pruebas unitarias completas:
|
| 88 |
+
python3 -m unittest tests/test_nova_suite.py
|
| 89 |
+
```
|
| 90 |
+
|
| 91 |
+
---
|
| 92 |
+
|
| 93 |
+
## 📄 Especificación de Metadatos
|
| 94 |
+
Para consultar el estándar de metadatos propios de Nova incrustados en GGUF, revisa [docs/NOVA_GGUF_SPEC.md](docs/NOVA_GGUF_SPEC.md).
|
| 95 |
+
|
| 96 |
+
---
|
| 97 |
+
|
| 98 |
+
## 📜 Licencia y Autoría
|
| 99 |
+
|
| 100 |
+
Copyright (c) 2026 **ModernoTech / José Luis Brea**.
|
| 101 |
+
Distribuido bajo la Licencia MIT. Consulta el archivo [LICENSE](LICENSE) para más detalles.
|