# Antigravity IDE - AI Provider Edition

## Version 2.0.1-ai-providers-1

**Antigravity IDE with 17+ Pre-configured AI Provider Presets**

![Antigravity](https://img.shields.io/badge/Antigravity-v2.0.1-blue)
![AI Providers](https://img.shields.io/badge/AI_Providers-17%2B-green)
![Platform](https://img.shields.io/badge/Platform-Linux_amd64-purple)

## 🎯 Overview

This is a custom build of Antigravity IDE with comprehensive GUI support for managing multiple AI providers. Features include:

- ✅ **17+ Pre-configured Provider Presets** - One-click setup for popular AI providers
- ✅ **Model Auto-Fetching** - Automatically discover available models from provider APIs
- ✅ **Connection Testing** - Validate API keys and endpoints before use
- ✅ **Persistent Settings** - All configurations saved automatically
- ✅ **Modern GUI Interface** - Beautiful, responsive interface built with HTML/CSS/JS

## 🌐 Supported AI Providers

### Direct API Providers
- **OpenAI** - GPT-4o, GPT-4o-mini, GPT-4-turbo, GPT-3.5-turbo
- **Anthropic** - Claude 3.5 Sonnet, Claude 3 Opus, Claude 3 Haiku
- **Groq** - Llama 3.1, Mixtral models
- **OpenRouter** - Access to 100+ models

### OpenAI-Compatible Providers
- **OpenCode Zen/Go** - GLM, Kimi, MiniMax, DeepSeek, Qwen models
- **NVIDIA NIM** - NVIDIA's AI endpoints
- **Kilo.ai Gateway** - Kilo.ai services
- **Crof.ai** - OpenAI-compatible endpoint
- **OpenAdapter** - 0G models
- **Z.ai Coding** - GLM models

### Anthropic-Compatible Providers
- **OpenCode Zen/Go (Anthropic)** - Claude models via OpenCode

### Google Providers
- **Google Gemini (API Key)** - Gemini models via OpenAI-compatible endpoint
- **Google Gemini (OAuth)** - Gemini via Google Cloud
- **Google Antigravity (OAuth)** - Antigravity-specific models including:
  - antigravity-gemini-3-flash
  - antigravity-gemini-3-pro
  - antigravity-gemini-3.1-pro
  - antigravity-claude-sonnet-4-6
  - antigravity-claude-opus-4-6-thinking
  - Plus all standard Gemini models

### Special Providers
- **Command Code** - 20+ models from DeepSeek, Anthropic, OpenAI, Moonshot, GLM, MiniMax, Qwen, StepFun, Google
- **Ollama (Local)** - Local model hosting

## 🚀 Installation

### From .deb Package

```bash
# Download the .deb file
wget https://github.rommark.dev/admin/antigravity-ai-providers/releases/latest/download/antigravity_2.0.1-ai-providers-1_amd64.deb

# Install the package
sudo dpkg -i antigravity_2.0.1-ai-providers-1_amd64.deb

# Launch
antigravity

# Or find "Antigravity IDE" in your application menu
```

### Requirements

- Ubuntu/Debian-based Linux distribution
- GTK3 support
- amd64 (x86_64) architecture

## 💡 Usage

### Adding a Provider (One-Click Setup)

1. Open Antigravity IDE
2. Navigate to **Settings** → **AI Provider Settings**
3. Click **"Add from Preset"**
4. Select your provider (e.g., "Google Antigravity (OAuth)")
5. Enter your API key
6. Click **"Add Provider"**
7. Click **"Test Connection"** to verify

### Adding a Custom Provider

1. Open AI Provider Settings
2. Click **"Add Custom Provider"**
3. Fill in details:
   - Provider Name
   - API Type
   - Endpoint URL
   - API Key
   - Models (comma-separated)
4. Click **"Add"**

### Fetching Models

1. Select your provider from the list
2. Click **"Fetch Models"**
3. Wait for models to load
4. Select your default model

### Configuring Settings

- **Temperature**: Response creativity (0.0-2.0)
- **Max Tokens**: Maximum response length (100-32000)
- **Streaming**: Enable real-time responses
- **Default Provider**: Set your preferred provider

## 📦 Package Contents

```
antigravity_2.0.1-ai-providers-1_amd64.deb
├── opt/antigravity/              # Main application
│   ├── antigravity              # Main executable
│   ├── resources/              # Application resources
│   ├── lib*/                    # Libraries
│   └── locales/                # Language files
├── DEBIAN/                      # Package metadata
│   ├── control
│   ├── preinst
│   ├── postinst
│   ├── prerm
│   └── postrm
└── usr/share/applications/     # Desktop entry
    └── antigravity.desktop
```

## 🔧 Features

### Backend Features
- ✅ AIProviderService for provider management
- ✅ 14 new IPC handlers for AI operations
- ✅ Preset-based provider creation
- ✅ Model fetching and validation
- ✅ Connection testing
- ✅ Settings management

### Frontend Features
- ✅ TypeScript API wrapper
- ✅ Complete HTML/CSS/JS GUI implementation
- ✅ Provider cards with status badges
- ✅ Preset selector dropdown
- ✅ Model auto-fetch functionality
- ✅ Settings panel with sliders and toggles
- ✅ Toast notifications
- ✅ Modal dialogs
- ✅ Loading states

## 📚 Documentation

The package includes comprehensive documentation:

- **README.md** - Installation and usage guide
- **CHANGELOG.md** - Version history
- **AI_PROVIDER_README.md** - Integration guide
- **AI_PROVIDER_SPECIFICATION.md** - Full API documentation
- **IMPLEMENTATION_SUMMARY.md** - Implementation overview

## 🐛 Troubleshooting

### Provider not connecting

1. **Check API Key**
   - Verify API key is correct
   - Check if key has expired
   - Ensure key has necessary permissions

2. **Check Endpoint**
   - Verify endpoint URL is correct
   - Check for typos in URL
   - Ensure provider is not down

3. **Network Issues**
   - Check firewall settings
   - Verify internet connection
   - Try with VPN if behind corporate firewall

### Models not loading

1. Click **"Fetch Models"** button
2. Check API key permissions
3. Verify provider supports model listing
4. Check browser console for errors

### Installation Issues

```bash
# Fix broken dependencies
sudo apt-get install -f

# Reinstall if needed
sudo dpkg -r antigravity
sudo dpkg -i antigravity_2.0.1-ai-providers-1_amd64.deb
```

## 🔒 Security

- API keys stored securely in app config
- HTTPS connections validated
- No data sent to third parties without consent
- User controls all provider configurations

## 📊 Version History

### 2.0.1-ai-providers-1 (Current)
- Added 17+ provider presets
- One-click provider setup
- Model auto-fetching
- Connection testing
- Modern GUI interface
- Comprehensive documentation

### 2.0.0 (Original)
- Initial Antigravity release
- Basic IDE features

## 🙏 Acknowledgments

Provider presets imported from:
- [Codex Launcher - Any AI Provider](https://github.rommark.dev/admin/Codex-Launcher---Any-AI-Porovider)

## 📞 Support

For issues or questions:
1. Check existing issues in this repository
2. Create new issue with details
3. Include logs if reporting bugs
4. Specify your provider and model

## 📄 License

Same as original Antigravity application.

## 🎉 Summary

This release brings Antigravity to the next level with:
- ✅ 17+ pre-configured AI providers
- ✅ One-click setup for popular providers
- ✅ Model auto-fetching
- ✅ Connection testing
- ✅ Comprehensive GUI
- ✅ Full documentation

**Enjoy AI-powered development with Antigravity!**

---

Built with ❤️ | Version 2.0.1-ai-providers-1