GeminiCode : un assistant de programmation basé sur Gemini 2.5 fonctionnant dans les terminaux.

Introduction générale

GeminiCode 是一个在终端中运行的 AI 编程助手，由开发者在周末业余时间开发。它基于 Google 的 Gémeaux 2.5 Pro 模型，能读取和修改你电脑当前目录中的文件。这个工具的灵感来自 Anthropique (utilisé comme expression nominale) Claude Code，目标是为程序员提供一个直接在命令行中使用的助手。它是个实验项目，不是生产环境用的软件，可能有 bug，用户需谨慎使用。开发者建议只在测试环境或不重要的目录中使用，避免操作敏感文件。

Liste des fonctions

• 读取文件：自动读取当前目录及子目录中的所有文件内容。
• 修改文件：可以创建、编辑或删除文件，直接改变目录中的代码。
• 执行命令：能在终端中运行 bash 命令，执行简单操作。
• génération de codes：根据用户输入生成代码，比如写一个函数。
• Support de débogage：帮助分析错误信息并给出修复建议。

Utiliser l'aide

GeminiCode 是一个命令行工具，需要在终端中安装和运行。以下是详细步骤和操作指南，确保你能快速上手。注意：它会直接访问你当前目录的文件，没有明确权限提示，使用前务必确认目录安全。

Processus d'installation

1. Créer un environnement virtuel
   打开终端，输入以下命令创建一个隔离的 Python 环境，避免干扰其他项目：

python3 -m venv venv
source venv/bin/activate

运行第二条命令后，终端会显示 (venv)，表示环境激活成功。

2. 安装 GeminiCode
   在虚拟环境中输入：

pip install gemini-code

这会从 PyPI 下载并安装最新版本。安装过程通常几秒到一分钟，取决于网络速度。

3. 设置 API 密钥
   你需要一个 Google API 密钥来使用 Gemini 模型。获取方法：访问 https://ai.google.dev/，注册并生成密钥。然后在终端输入：

gemini setup YOUR_GOOGLE_API_KEY

l'interchangeabilité YOUR_GOOGLE_API_KEY 为你的实际密钥。设置成功后，工具就能连接模型。

4. 启动会话
   Entrez la commande suivante pour démarrer :

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. Générer le code
   输入类似：

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. 修改文件
   Entrée :

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. 执行命令
   Entrée :

Run ls command

它会执行 bash 命令并返回结果（仅限支持的简单命令）。

6. 退出会话
   Entrée :

/exit

会话结束，回到普通终端。

使用注意事项

• 请求限制：免费版每天 25 次请求，Tier 1 为 100 次。超出后会切换到 1.5 Pro 模型，但可能不稳定。
• 安全建议：只在测试目录使用，重要文件要备份。可以用 Docker 等容器运行，增加隔离性。
• problèmes courants：如果卡住，重启会话即可。查看帮助用 /help.

通过这些步骤，你可以在终端中使用 GeminiCode。它适合实验性编程任务，但不稳定，不适合正式开发。

scénario d'application

1. 快速测试代码
   你想试写一个小功能，比如计算器。可以用 GeminiCode 在测试目录生成代码，运行前手动检查。
2. 学习调试
   新手程序员遇到错误信息看不懂，可以粘贴到 GeminiCode，获取简单解释和修改建议。
3. 临时文件操作
   需要批量修改文件内容，比如加注释。用 GeminiCode 输入指令，几秒完成。

QA

1. GeminiCode 安全吗？
   不完全安全。它直接操作文件，没保护机制。建议只用在不重要目录，重要数据要备份。
2. Dois-je travailler en réseau ?
   是的，运行时需要联网调用 Google API。
3. 支持哪些文件类型？
   能读取任何文本文件，比如 .py,.txt，但主要为代码设计。
4. 超过请求限制怎么办？
   超出后自动用 1.5 Pro 模型，功能可能受限。建议等次日或升级账户。