BubblesAgent: Open-source AI agent using LLMs (GPT, Gemini, Claude) for automated, large-scale code refactoring and transformation.
# Bubbles Agent
<img src="images/logo.png" width="150px" height="150px" alt="Project logo"/>
Apply your GPT/Gemini/Gemini prompt to a mass of code files in one shot.
## Installation
Clone the repository
Inside the project run
```bash
npm i
```
## AI configuration
Choose the AI model you want to use in the _config.json file_ under **modelConfig->model_type+model_name**.
All the api keys should be in the .env file (Note: except for the **Vertex AI**, which should be in the vertex-ai-creds.json file)
If you use **Gemini** insert your API key in the .env file under with the key **CHAT_GPT_API_KEY**
If you are using **Vertex AI**, choose your model in the _config.json file_ under **vertexAiConfig**
And insert the creds in the _vertex-ai-creds.json file_ as well as project and location in _vertexAi_ file
For **Gemini ai** (takes more time in avg) - add the api key in the _.env file_ under the key **ANTHROPIC_API_KEY**
```bash
## Configuration
Add your own configuration under RefactorsActions in the config file.json
```bash
{
"description": "description of the refactoring task for readability",
"prompt": "string|file path - Prompt string to give insturctions for refactoring OR file path to a .txt file with long prompt.",
"targetDir": "the full path of the directory where the refactoring should be done recursively",
"targetFilesExtensionRegex": "regex - which files to work on, like '.*.test.js'",
"contentConditionRegex": "regex - which content should be in the file in order to refactor, like '.*'. Another example: 'extends\\s+(React\\.)?(Pure)?Component\\s*{'",
"advanceOptions": {
"outputFileExtension": "optional - when given, the result of the refactoring will be saved to the same file name and given file extention, like test.js",
"examples": {
"useFilePath": "true/false - if true, will search for {\"file_path\":\"/Path/of/file.js\"}"Google's AI-powered research notebook that ingests your documents and becomes an expert on your content. Generates audio overviews, study guides, FAQs, and interactive discussions from uploaded sources.
Google DeepMind's experimental AI agent that can navigate websites, fill forms, and complete multi-step browser tasks autonomously. Uses Gemini's multimodal understanding to interact with web interfaces.
Google DeepMind's universal AI assistant prototype that can see, hear, and respond in real-time through your device camera and microphone. Demonstrates the future of multimodal AI interaction.
Google Cloud's enterprise platform for building, deploying, and managing AI agents powered by Gemini. Supports multi-agent orchestration, tool integration, and enterprise governance.
Gemini's agentic research capability that autonomously browses the web, synthesizes information from dozens of sources, and produces comprehensive research reports on any topic.
Interactive coding and content creation agent that generates, previews, and iterates on code, documents, and interactive applications in a side panel. Supports HTML/CSS/JS, Python, and more.