| 1 | # Установка стека CascadeIDE на машину |
| 2 | |
| 3 | Краткий чеклист и рекомендации под твою конфигурацию. |
| 4 | |
| 5 | ## Характеристики машины (по systeminfo) |
| 6 | |
| 7 | - **ОС:** Windows 11 Pro (10.0.26200) |
| 8 | - **Память:** 64 GB RAM |
| 9 | - **CPU:** AMD64 Family 25 Model 116 (~3.8 GHz) |
| 10 | - **GPU:** NVIDIA GeForce RTX 4060 Laptop GPU, AMD Radeon 780M |
| 11 | |
| 12 | Под такой конфиг комфортно запускать модели 7B–13B в GPU и при необходимости крупнее — в CPU/RAM. |
| 13 | |
| 14 | --- |
| 15 | |
| 16 | ## 1. .NET 10 SDK |
| 17 | |
| 18 | Уже установлен (10.0.103). Проверка: |
| 19 | |
| 20 | ```powershell |
| 21 | dotnet --list-sdks |
| 22 | ``` |
| 23 | |
| 24 | Если нужно поставить: [Download .NET 10](https://dotnet.microsoft.com/download/dotnet/10.0). |
| 25 | |
| 26 | --- |
| 27 | |
| 28 | ## 2. Шаблоны Avalonia |
| 29 | |
| 30 | Установка (один раз): |
| 31 | |
| 32 | ```powershell |
| 33 | dotnet new install Avalonia.Templates |
| 34 | ``` |
| 35 | |
| 36 | Проверка: `dotnet new list` — в списке должны быть `avalonia.app`, `avalonia.mvvm` и др. |
| 37 | |
| 38 | --- |
| 39 | |
| 40 | ## 3. Ollama (локальные модели) |
| 41 | |
| 42 | Без Ollama приложение запустится, но чат/модели недоступны. |
| 43 | |
| 44 | **Установка под Windows:** |
| 45 | |
| 46 | - Вариант 1 (PowerShell): |
| 47 | ```powershell |
| 48 | irm https://ollama.com/install.ps1 | iex |
| 49 | ``` |
| 50 | - Вариант 2: скачать [OllamaSetup.exe](https://ollama.com/download/windows) с сайта. |
| 51 | |
| 52 | После установки сервис слушает **http://localhost:11434**. Первый запуск модели (например в терминале `ollama run llama3.2`) скачает модель и покажет её в CascadeIDE. |
| 53 | |
| 54 | **Требования:** Windows 10 22H2+, для GPU — драйверы NVIDIA 452.39+ или актуальные AMD. |
| 55 | |
| 56 | --- |
| 57 | |
| 58 | ## 4. Рекомендуемые модели под твоё железо |
| 59 | |
| 60 | | Класс | Примеры моделей | Комментарий | |
| 61 | |--------|------------------------|-------------| |
| 62 | | Быстрые (7B–8B) | `llama3.2`, `qwen2.5:7b`, `phi4` | Удобны для чата и подсказок по коду, хорошо помещаются в VRAM RTX 4060. | |
| 63 | | Средние (13B) | `qwen2.5:13b`, `llama3.1:8b` | При 8 GB VRAM часть может уйти в RAM — всё ещё приемлемо. | |
| 64 | | Крупные | `qwen2.5:32b`, `llama3.1:70b` | 64 GB RAM позволяют тянуть на CPU или гибрид; скорость ниже. | |
| 65 | |
| 66 | **Для ноутбука + MCP (tool calling) и кодинга на .NET** по умолчанию в настройках подставлена модель **qwen2.5-coder:7b** — поддерживает вызов инструментов и заточена под код. Установка: |
| 67 | |
| 68 | ```powershell |
| 69 | ollama pull qwen2.5-coder:7b |
| 70 | ``` |
| 71 | |
| 72 | Выбранная в IDE модель сохраняется в настройках (`%LocalAppData%\CascadeIDE\settings.toml`) и подставляется при следующем запуске. |
| 73 | |
| 74 | Команды (после установки Ollama): |
| 75 | |
| 76 | ```powershell |
| 77 | ollama pull qwen2.5-coder:7b |
| 78 | ollama pull llama3.2 |
| 79 | ollama pull qwen2.5:7b |
| 80 | ``` |
| 81 | |
| 82 | Список установленных моделей в CascadeIDE подтягивается автоматически при запуске. |
| 83 | |
| 84 | --- |
| 85 | |
| 86 | ## 4.1. MCP: агент ↔ IDE |
| 87 | |
| 88 | Чтобы агент (Cursor и др.) управлял CascadeIDE по MCP, IDE нужно запускать с флагом **`--mcp-stdio`**. Тогда она поднимает MCP-сервер на stdin/stdout; хост (например Cursor) подключается к этому процессу и вызывает тулы: открытие файла, брейкпоинты, превью, подтверждения. |
| 89 | |
| 90 | Подробно и пример конфига Cursor: **[docs/MCP-PROTOCOL.md](docs/MCP-PROTOCOL.md)**. |
| 91 | |
| 92 | --- |
| 93 | |
| 94 | ## 5. Сборка и запуск CascadeIDE |
| 95 | |
| 96 | Из каталога репо **open**: |
| 97 | |
| 98 | ```powershell |
| 99 | cd cascade-ide |
| 100 | dotnet restore |
| 101 | dotnet build |
| 102 | dotnet run |
| 103 | ``` |
| 104 | |
| 105 | Окно покажет статус Ollama и список локальных моделей (или подсказку установить/запустить Ollama). |
| 106 | |