🤖 AI Coder - Локальный помощник для программирования

AI Coder - это удобный инструмент для работы с локальными AI-моделями программирования через Ollama. Запускайте мощные модели lowcode прямо на своём компьютере без интернета.

📦 Установка Ollama

Linux/macOS: curl -fsSL https://ollama.com/install.sh | sh Комментарий: Эта команда автоматически скачает и установит Ollama на вашу систему. Она поддерживает все основные Linux дистрибутивы и macOS.

Windows: Скачайте установщик с официального сайта и установите как обычную программу: https://ollama.com/download/windows

Комментарий: Для Windows требуется Windows 10 или более новая версия. Установщик сам настроит все необходимые компоненты. Работает не стабильно, рекомендуется использовать WSL.

▶️ Запуск AI Coder

Клонирование репозитория:

git clone https://github.com/Cryptonit63/local_coder.git cd local_coder

Комментарий: Эти команды скачивают весь проект из репозитория на GitHub и переходят в папку с файлами проекта.

Запуск главного меню:

./ai-menu.sh

Комментарий: После запуска меню автоматически проверит наличие Ollama и предложит установить недостающие модели. Также будет запущен Ollama сервер при необходимости.

🧠 Доступные модели

Модель | Команда установки | Размер | Скорость | Назначение

• DeepSeek-Coder 1.3B | ollama pull deepseek-coder:1.3b | 0.8 GB | ⚡⚡⚡⚡⚡ | Быстрый старт, обучение
• DeepSeek-Coder 6.7B | ollama pull deepseek-coder:6.7b | 4.1 GB | ⚡⚡⚡ | Баланс качества и скорости
• Qwen2.5-Coder 7B | ollama pull qwen2.5-coder:7b | 4.4 GB | ⚡⚡ | Современный код, 20+ языков
• CodeLlama 7B | ollama pull codellama:7b | 4.0 GB | ⚡⚡⚡ | Классика, надёжная
• Codestral | ollama pull codestral:latest | ~4 GB | ⚡⚡⚡ | Эффективная, от Mistral AI

Комментарий: Все модели можно установить как через меню, так и вручную с помощью команд ollama pull. Установка происходит автоматически при первом запуске модели через меню.

🎮 Функции меню

Основные функции:

• Запуск любой модели — с автоматической проверкой установки
• Установка моделей — по одному клику или все сразу
• Просмотр установленных — список всех доступных моделей
• Удаление моделей — управление пространством
• Проверка системы — диагностика и ресурсы
• Прогресс-бары — видимость процесса установки

Запуск моделей:

• ollama run deepseek-coder:1.3b
• ollama run deepseek-coder:6.7b
• ollama run qwen2.5-coder:7b
• ollama run codellama:7b
• ollama run codestral:latest

Комментарий: Эти команды запускают конкретные модели. Если модель не установлена, Ollama предложит её установить. Запускать в диалоговом окне сервера.

💡 Примеры промтов, их использования и варианты ответо:

Написание кода:

Написать функцию на Python

"Напиши функцию на Python, которая проверяет, является ли строка палиндромом"

Комментарий: AI поможет создать функцию с правильной логикой и стилем кодирования.

Объяснение кода:

Объяснить существующий код

"Объясни, что делает этот код: def factorial(n): return 1 if n <= 1 else n * factorial(n-1)"

Комментарий: AI предоставит подробное объяснение работы рекурсивной функции.

Поиск ошибок:

Найти ошибки в коде

"Найди ошибки в этом коде: for i in range(10) print(i)"

Комментарий: AI укажет на отсутствие двоеточия после условия цикла.

Оптимизация:

Оптимизировать производительность

"Оптимизируй этот код: result = []; for i in range(100): if i % 2 == 0: result.append(i**2)"

Комментарий: AI предложит более эффективные способы реализации с использованием list comprehensions.

Генерация документации:

Создать документацию

"Напиши документацию к этой функции в формате Google Docstring"

Комментарий: AI создаст профессиональную документацию к вашему коду.

Создание тестов:

Написать тесты

"Напиши unit-тесты для этой функции"

Комментарий: AI сгенерирует тесты с использованием подходящих фреймворков.

🔧 Установка удобных ярлыков

Выполните скрипт для настройки удобных команд: ./setup-aliases.sh

Комментарий: Этот скрипт добавляет ярлыки в ваши профили терминала (zsh для macOS, bash для Linux), чтобы вы могли быстро запускать AI Coder.

После перезапуска терминала станут доступны команды: ai # запустить быструю модель ai-models # список установленных ai-menu # открыть главное меню ai-help # показать инструкцию ai-quick # примеры вопросов

Комментарий: После выполнения скрипта нужно перезапустить терминал или выполнить команду source ~/.zshrc (для macOS) или source ~/.bashrc (для Linux), чтобы ярлыки стали активны.

🌐 Поддержка ОС

Платформа | Поддержка | Особенности macOS | ✅ Полная | Тестировано на Monterey+ Linux | ✅ Полная | Ubuntu, Fedora, Arch и другие Windows | ✅ Через WSL | Или установка через PowerShell

Для Windows (вариант с WSL): wsl --install

Комментарий: Эта команда устанавливает Windows Subsystem for Linux, который позволяет запускать Linux среду в Windows.

• Затем в терминале Ubuntu:
• cd /mnt/c/Users/ВашеИмя/Desktop/AI-Coder-For-Friends
• ./ai-menu.sh

Комментарий: Замените /mnt/c/Users/ВашеИмя/Desktop/AI-Coder-For-Friends на реальный путь к папке с проектом.

📚 Примеры вопросов

Запустите скрипт для получения примеров запросов: python3 quick-test.py

Комментарий: Этот скрипт показывает примеры вопросов, которые можно задавать AI моделям для решения задач программирования.

Примеры вопросов:

• "Напиши функцию на Python, которая проверяет, является ли строка палиндромом"
• "Объясни, что делает этот код: def factorial(n): return 1 if n <= 1 else n * factorial(n-1)"
• "Найди ошибки в этом коде: for i in range(10) print(i)"

🛠️ Устранение неполадок

Проверка установки Ollama: ollama --version

Комментарий: Показывает версию установленной Ollama. Если команда не работает, значит Ollama не установлена.

Проверка установленных моделей: ollama list

Комментарий: Показывает список всех установленных моделей. Если список пуст, значит модели не установлены.

Запуск Ollama сервера вручную: ollama serve

Комментарий: Запускает Ollama сервер вручную. Обычно это делает меню автоматически, но иногда нужно запустить вручную.

Основные проблемы и решения:

Модель не запускается?

• Проверьте, установлена ли Ollama: ollama --version
• Убедитесь, что сервер запущен: ollama serve
• Перезапустите меню: ./ai-menu.sh

Нет интернета?

• После установки модели работают офлайн
• Установка новых моделей требует интернета

Недостаточно места?

• Удалите ненужные модели через меню: ollama rm model_name

Проблемы с цветами?

• Терминал поддерживает ANSI-коды
• Цвета используются только в интерфейсе

📄 Лицензия

MIT License. Свободное использование, изменение и распространение.

👨‍💻 Автор

Vlasss Создано с ❤️ для сообщества разработчиков