Files
ag-x/README.md
Admin e6b6405912 Initial commit: Antigravity v2.0.1 with AI Provider GUI Support
Features:
- 17+ pre-configured AI provider presets
- One-click provider setup
- Model auto-fetching
- Connection testing
- Modern GUI interface
- Comprehensive documentation

Presets include:
- OpenAI (GPT-4o, GPT-4o-mini, GPT-4-turbo)
- Anthropic (Claude 3.5 Sonnet, Claude 3 Opus, Claude 3 Haiku)
- Google Gemini (API Key & OAuth)
- Google Antigravity (OAuth) - Antigravity-specific models
- Groq, OpenRouter, OpenCode, NVIDIA NIM, Ollama, and more
2026-05-22 10:20:13 +00:00

256 lines
7.0 KiB
Markdown

# 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