Create README.md

README.md

@@ -9,16 +9,121 @@ app_file: app.py
 pinned: false
 license: mit
 ---
-# 🤖 Eroha AgentAPI v5.8 — AutoRecovery + Smart Dashboard
-
-Production-ready AI agent system with:
-- Automatic Hugging Face token validation & recovery
-- Circuit Breaker protection
-- Watchdog health monitoring
-- Local fallback model
-- Interactive Smart Dashboard
-
-🌐 Interface:
-- `/ui` — main Gradio interface
-- `/health` — API health status
-- `/inference` — REST endpoint
+
+# 🤖 Eroha AgentAPI v5.8 — AutoRecovery + Smart Dashboard Edition
+
+> **Production-grade AI Infrastructure built for Hugging Face Spaces**  
+> Разработано архитектурой уровня Enterprise для полной автономности и стабильности.
+
+---
+
+## 🚀 Ключевые особенности
+
+✅ **Auto Token Recovery** — автоматическая проверка и восстановление токена Hugging Face  
+✅ **Circuit Breaker FSM** — защита от каскадных ошибок Router API  
+✅ **Watchdog Monitoring** — автоматический health-check каждые 5 минут  
+✅ **Fallback Engine** — локальная резервная модель (offline backup)  
+✅ **Smart Dashboard** — визуальный контроль всех системных метрик  
+✅ **REST API + Gradio UI** — единая точка входа для пользователя и API  
+
+---
+
+## 🧩 Архитектура
+
+
+---
+
+## ⚙️ Установка и запуск
+
+### 1️⃣ Создай или открой Space  
+Тип: **Gradio SDK**
+
+### 2️⃣ Загрузите файлы:
+- `app.py` — основной код API (версия 5.8)
+- `requirements.txt`
+- `README.md` — этот файл (с YAML-конфигурацией сверху)
+
+### 3️⃣ Добавь токен:
+В **Settings → Repository secrets** добавь переменную:
+
+### 4️⃣ Запуск:
+Через 1–2 минуты появится статус: ✅ **Running**  
+Интерфейсы:
+- 🌐 `/ui` — Gradio интерфейс  
+- 💓 `/health` — состояние системы  
+- ⚙️ `/inference` — REST API  
+
+---
+
+## 🧠 REST API Endpoints
+
+| Endpoint | Описание | Метод |
+|-----------|-----------|--------|
+| `/health` | Проверка токена, памяти и Circuit Breaker | GET |
+| `/inference` | Основной API-интерфейс (Router → Fallback) | POST |
+| `/metrics` | Prometheus метрики | GET |
+| `/ui` | Основной Gradio интерфейс | WEB |
+
+---
+
+## 🧰 Пример запроса
+
+```bash
+curl -X POST https://hf.space/your-space-name/inference \
+     -H "Content-Type: application/json" \
+     -d '{
+       "prompt": "Расскажи фантастическую историю про ИИ",
+       "model": "microsoft/phi-3-mini-4k-instruct"
+     }'
+
+| Индикатор                 | Цвет    | Значение                           | Действие                    |
+| ------------------------- | ------- | ---------------------------------- | --------------------------- |
+| 🟢 **Token Valid**        | Зеленый | Токен активен и проходит проверку  | ✅ Всё в порядке             |
+| 🔴 **Token Invalid**      | Красный | Токен просрочен или недействителен | 🔁 Проверить HF_TOKEN       |
+| 🟢 **Circuit: CLOSED**    | Зеленый | API стабилен                       | ✅ Работа нормальная         |
+| 🟡 **Circuit: HALF_OPEN** | Желтый  | Тест восстановления после сбоя     | ⚠️ Наблюдать                |
+| 🔴 **Circuit: OPEN**      | Красный | API отключен из-за ошибок          | 🧠 Активирован fallback     |
+| 🟢 **Memory < 85%**       | Зеленый | Ресурсы в норме                    | ✅ Нормальная загрузка       |
+| 🔴 **Memory > 90%**       | Красный | Перегрузка памяти                  | ⚙️ Перезапуск рекомендуется |
+| 🟢 **Watchdog Active**    | Зеленый | Автоматические проверки активны    | ✅ Работа стабильна          |
+
+🧱 Архитектурные преимущества
+
+Асинхронная модель (FastAPI + aiohttp)
+
+Отказоустойчивость (fallback + circuit breaker)
+
+Локальная tiny модель — всегда доступна
+
+Безопасное хранение секретов (через Hugging Face Secrets)
+
+Zero-downtime обновления и автопроверка
+
+🔗 Полезные ссылки
+
+Spaces SDK Reference
+
+Transformers Documentation
+
+Gradio API Docs
+
+🧠 Автор и лицензия
+
+Автор: Eroha Systems
+Архитектор: AI Infrastructure Architect (DevOps/ML Engineering, 30+ лет опыта)
+Лицензия: MIT
+Версия: v5.8 Stable AutoRecovery
+
+
+---
+
+✅ **Как использовать:**
+1. Перейди во вкладку **Files → README.md**
+2. Нажми **Edit**
+3. Вставь этот файл полностью
+4. Сохрани (**Commit changes**)
+5. Через 1–2 минуты Space соберётся и запустится без ошибок  
+
+---
+
+Хочешь, я сделаю **production-версию README+Config bundle** (с интегрированным `.env` шаблоном и auto-refresh описанием), чтобы просто залить одним архивом в Space?