Gemini Engineer is an interactive, AI-driven terminal application designed to serve as a software engineering assistant. It utilizes Google's Gemini API to facilitate intelligent coding assistance and file system operations, enabling developers to enhance their productivity.

Features

• AI-Powered Coding Assistant: Harnesses the capabilities of Google's Gemini Pro model for insightful code analysis and recommendations.
• File System Operations: Perform file operations such as reading, creating, and editing files through AI function calls.
• Interactive Terminal Interface: Offers a rich and dynamic terminal user interface powered by the rich library and prompt_toolkit.
• Function Calling: Integrates AI reasoning with local file operations seamlessly.
• Context Management: Enhance assistance by adding files and directories to the conversation context.
• Streaming Responses: Provides real-time AI responses, delivering visual feedback to users.
• Safety Features: Incorporates security measures to prevent unauthorized directory traversal and handle binary files correctly.

Command-Line Interface (CLI)

The user interface is designed for ease of use, allowing interaction with AI through direct commands. Example commands include:

🤖 gemini-engineer> /add main.py
🤖 gemini-engineer> Analyze this code and suggest improvements.
🤖 gemini-engineer> Create a simple Python calculator in calc.py.

Available AI Tools

The AI assistant is equipped with several file system tools designed for efficient handling of coding tasks:

• read_file(file_path): Reads the content of a specified file.
• create_file(file_path, content): Creates a new file or overwrites an existing one.
• list_directory(dir_path): Lists the contents of a directory.

Security Features

Safety is a key concern in Gemini Engineer:

• Path Validation: Prevents directory traversal attacks.
• File Size Limits: Limits file operations to a maximum of 1MB.
• Binary File Detection: Automatically skips binary files to avoid unsafe operations.

Architecture

Gemini Engineer incorporates a thoughtful architecture to ensure optimal performance and security:

• Core Components: Main application class, tool functions for file handling, and safety utilities for path normalization.
• Technology Stack: Developed using tools like google-generativeai, rich for terminal UI enhancements, and pydantic for data validation.

Contributing

Contributions to Gemini Engineer are welcomed. To get involved:

1. Fork the repository and create a feature branch.
2. Commit changes and push them to GitHub.
3. Open a pull request for review.

Support and Troubleshooting

For any questions or issues, users can check the troubleshooting section or review existing issues on GitHub. New issues can be reported with detailed information to facilitate swift resolutions.

Gemini Engineer is poised to transform the coding experience, making it more efficient and user-friendly.