GeminiCode: ассистент программирования с искусственным интеллектом на базе Gemini 2.5, работающий в терминалах

Общее введение

GeminiCode - это ассистент программирования с искусственным интеллектом, работающий в терминале, разработанный разработчиками в свободное время по выходным. В его основе лежит Google Близнецы 2.5 Pro, которая читает и изменяет файлы в текущей директории вашего компьютера. Этот инструмент создан по мотивам Антропология (используется в форме номинального выражения) Клод Code, цель которого - предоставить программистам помощника для использования непосредственно из командной строки. Это экспериментальный проект, а не программа для производственных сред, и в нем могут быть ошибки, поэтому пользователям следует использовать его с осторожностью. Разработчик предлагает использовать его только в тестовых средах или в неважных каталогах, чтобы избежать манипуляций с конфиденциальными файлами.

Список функций

• Читать файл: Автоматическое чтение содержимого всех файлов в текущем каталоге и подкаталогах.
• изменить документ: Файлы можно создавать, редактировать или удалять для изменения кода непосредственно в каталоге.
• выполнить команду: Вы можете запустить команду bash в терминале для выполнения простых операций.
• генерация кода: Генерация кода на основе пользовательского ввода, например, написание функции.
• Поддержка отладки: Помогает анализировать сообщения об ошибках и давать предложения по их устранению.

Использование помощи

GeminiCode - это инструмент командной строки, который необходимо установить и запустить в терминале. Ниже приведены подробные шаги и инструкции, чтобы вы могли быстро начать работу. Примечание: Программа получает прямой доступ к файлам в текущем каталоге без явных запросов на разрешение, поэтому перед ее использованием убедитесь, что ваш каталог безопасен.

Процесс установки

1. Создание виртуальной среды
   Откройте терминал и введите следующую команду, чтобы создать изолированную среду Python и избежать вмешательства в другие проекты:

python3 -m venv venv
source venv/bin/activate

После выполнения второй команды в терминале появится сообщение (venv)указывает на то, что среда была успешно активирована.

2. Установка GeminiCode
   Входит в виртуальную среду:

pip install gemini-code

Это позволит загрузить и установить последнюю версию с PyPI. Процесс установки обычно занимает от нескольких секунд до минуты, в зависимости от скорости сети.

3. Установка ключа API
   Для использования модели Gemini вам понадобится ключ Google API. Чтобы получить его: посетите https://ai.google.dev/Зарегистрируйтесь и сгенерируйте ключ. Затем введите его в терминал:

gemini setup YOUR_GOOGLE_API_KEY

взаимозаменяемость YOUR_GOOGLE_API_KEY для вашего фактического ключа. После успешной настройки инструмент сможет подключиться к модели.

4. начать сеанс
   Введите следующую команду для запуска:

gemini

Если появится сообщение об отсутствии модуля questionaryБег:

pip install questionary

Или укажите запуск модели:

gemini --model models/gemini-2.5-pro-exp-03-25

При запуске терминал переходит в интерактивный режим.

базовая операция

1. Просмотр файлов каталога
   Введите его в сессию:

What files are in this directory?

Инструмент выведет список всех файлов в текущем каталоге, например main.py, иreadme.txt.

2. Сгенерировать код
   Входы аналогичны:

Create a simple Python function that calculates the Fibonacci sequence

Инструмент генерирует код и отображает его, например:

def fibonacci(n):
if n <= 1:
return n
return fibonacci(n-1) + fibonacci(n-2)

Вы можете скопировать в файл или позволить инструменту писать напрямую.

3. изменить документ
   Вход:

Add a print statement to main.py

В нем будет написано main.pyДобавить print("Hello"), а затем сохраните. Примечание: Для прямого изменения файла нет шага подтверждения.

4. отладочный код
   Вставьте сообщение об ошибке, например:

Help me debug this error message: NameError: name 'x' is not defined

Инструмент анализирует и рекомендует определять переменные x.

5. выполнить команду
   Вход:

Run ls command

Он выполнит команду bash и вернет результат (поддерживаются только простые команды).

6. выйти из системы (вычисления)
   Вход:

/exit

Сессия завершается, и вы возвращаетесь к обычному терминалу.

Меры предосторожности при использовании

• Ограничения по запросам: 25 запросов в день для бесплатной версии, 100 - для Tier 1. При превышении переключается на модель 1.5 Pro, но может работать нестабильно.
• Рекомендации по безопасности: Используйте его только в тестовом каталоге и создавайте резервные копии важных файлов. Можно запускать в контейнерах типа Docker для повышения изоляции.
• общие проблемы: Если он застрянет, просто перезапустите сеанс. См. справку /help.

С помощью этих шагов вы сможете использовать GeminiCode в терминале. Он подходит для экспериментальных задач программирования, но недостаточно стабилен для формальной разработки.

сценарий применения

1. Код быстрого тестирования
   Вы хотите протестировать написание небольшой функции, например, калькулятора. Вы можете использовать GeminiCode для генерации кода в тестовом каталоге и вручную проверить его перед запуском.
2. Учимся отлаживать
   Начинающие программисты, столкнувшиеся с непонятными сообщениями об ошибках, могут вставить их в GeminiCode, чтобы получить простые объяснения и предложения по их изменению.
3. Операции с временными файлами
   Вам нужно массово изменить содержимое файла, например, добавить комментарии. Используйте GeminiCode для ввода команд и завершения работы за считанные секунды.

QA

1. Безопасен ли GeminiCode?
   Он не является полностью безопасным. Он работает напрямую с файлами без механизмов защиты. Рекомендуется использовать его только в неважных каталогах и резервировать важные данные.
2. Нужна ли мне сеть?
   Да, для вызова Google API программе требуется подключение к Интернету.
3. Какие типы файлов поддерживаются?
   может прочитать любой текстовый файл, например .py, и.txtНо в основном он предназначен для работы с кодом.
4. Что делать, если я превышу лимит запросов?
   Модели 1.5 Pro автоматически используются после превышения лимита, и их функциональность может быть ограничена. Мы рекомендуем дождаться следующего дня или обновить аккаунт.