

# Jarvis Demo (Runtime Prototype)

Это демо-сборка **Jarvis Runtime Prototype**.

Jarvis предназначен для работы с разными AI-сервисами.
Ты сам выбираешь, к какому AI он будет подключаться.

⚠️ **Важно:**
Jarvis **не содержит встроенного AI**.
Он подключается к выбранному AI-сервису по **твоему API-ключу**.
Это ожидаемо, нормально и безопасно.

---

## Как запустить

1. Открой файл `.env`
2. Вставь свой OpenAI-совместимый API-ключ
3. Запусти `JarvisDemo.exe`
4. Открой браузер и перейди по адресу:
   👉 [http://localhost:4000/jarvis.html](http://localhost:4000/jarvis.html)

---

## Что нужно, чтобы Jarvis заработал

Всего **3 простых шага**.

---

### 1️⃣ Выбери AI-сервис

Jarvis поддерживает популярные AI-провайдеры:

* Mistral
* DeepSeek
* xAI (Grok)
* HuggingFace
* Google Gemini
* Anthropic (Claude)

👉 Нужно выбрать **любой один**.
👉 Если один не понравился — просто меняешь ключ.

---

### 2️⃣ Получи API-ключ

API-ключ — это длинная строка из букв и цифр.

Где получить ключ:

* **Mistral** → [https://console.mistral.ai](https://console.mistral.ai)
* **DeepSeek** → [https://platform.deepseek.com](https://platform.deepseek.com)
* **HuggingFace** → [https://huggingface.co/settings/tokens](https://huggingface.co/settings/tokens)
* **xAI** → [https://console.x.ai](https://console.x.ai)
* **Google Gemini** → [https://aistudio.google.com](https://aistudio.google.com)
* **Anthropic** → [https://console.anthropic.com](https://console.anthropic.com)

💡 Обычно это занимает **1–2 минуты**.

---

### 3️⃣ Вставь ключ в файл `.env`

Рядом с `JarvisDemo.exe` находится файл `.env`.
Открой его обычным Блокнотом.

Внутри уже есть примеры.
Тебе нужно **раскомментировать один вариант** и вставить свой ключ.

**Пример (Mistral):**

```
LLM_PROVIDER=openai-compatible
LLM_API_KEY=ВСТАВЬ_СЮДА_СВОЙ_КЛЮЧ
```

**Пример (Google Gemini):**

```
LLM_PROVIDER=gemini
GEMINI_API_KEY=ВСТАВЬ_СЮДА_СВОЙ_КЛЮЧ
```

👉 Ничего больше менять не нужно.
👉 Один ключ = один работающий Jarvis.

---

## Как запустить Jarvis

1. Запусти `JarvisDemo.exe`
2. Открой браузер
3. Перейди по адресу:
   👉 [http://localhost:4000/jarvis.html](http://localhost:4000/jarvis.html)

Готово. Можно общаться 🙂

---

## Если что-то не работает

Не паникуй — в большинстве случаев всё решается за несколько секунд.

### ❌ Jarvis не отвечает

* Проверь, что ключ вставлен **без пробелов**
* Проверь, что выбран **только один провайдер**
* Попробуй другой AI-сервис (просто поменяй ключ)

### ❌ Ошибка доступа или лимитов

* Некоторые сервисы требуют включить доступ или оплату
* Это ограничение **AI-провайдера**, а не Jarvis

---

## Можно ли менять AI-провайдера?

Да.
Хоть каждый день.

Jarvis — это оболочка (runtime).
AI ты выбираешь сам.

---

## Важно знать

* Jarvis отправляет данные **только** выбранному AI-провайдеру
* API-ключ хранится **только у тебя**
* Это демо-версия для знакомства и тестирования

---

## Коротко

Скачал → получил ключ → вставил → запустил → общаешься

Без регистрации.
Без аккаунтов Jarvis.
Без лишней херни.

---

## Профили провайдеров (v1.1)

Jarvis поддерживает **профили провайдеров** — отдельные `.env` файлы для каждого AI-сервиса.

Это сделано специально, чтобы упростить переключение между провайдерами
и убрать путаницу с ключами, URL и настройками.

---

### Как это работает

В папке `providers/` лежат готовые профили:

* `Anthropic/`
* `Google (Gemini)/`
* `DEEPSEEK/`
* `MISTRAL/`
* `HUGGINGFACE/`
* `XAI/`
* `OpenAI-compatible/`

Каждый профиль содержит свой `.env` файл, уже настроенный под конкретного провайдера.

---

### Как выбрать провайдера (самый простой способ)

1️⃣ Открой папку нужного провайдера
2️⃣ Скопируй файл `.env`
3️⃣ Вставь его рядом с `JarvisDemo.exe`
4️⃣ Вставь свой API-ключ
5️⃣ Запусти Jarvis

Готово.
Без переключателей, перезапусков и пересборок.

---

### Зачем это сделано

* чтобы не путать API-ключи
* чтобы быстро менять провайдера (копировать один файл вместо правки десятков переменных)
* чтобы демо работало стабильно
* чтобы каждый провайдер был изолирован на уровне конфигурации

Если один AI перестал устраивать — просто используешь другой профиль.

Jarvis остаётся тем же.

---

### Важно

* В демо-сборке **нет встроенных API-ключей**
* Все ключи хранятся **только у тебя**
* Jarvis не отправляет данные никуда, кроме выбранного AI-провайдера

---

### Коротко

Один провайдер → один `.env`
Скопировал → вставил ключ → работает


