110 lines
3.5 KiB
Markdown
110 lines
3.5 KiB
Markdown
# AG X — Antigravity Fork
|
|
|
|
**AG X** is a fork of the Antigravity desktop application with enhanced multi-provider support. It allows you to use Google OAuth or any custom OpenAI-compatible API provider.
|
|
|
|
|
|
|
|
## Features
|
|
|
|
- 🔄 **Multi-Provider Support** — Switch between Google OAuth and custom API providers
|
|
- ⚡ **Custom Endpoints** — Configure your own OpenAI-compatible API endpoints
|
|
- 🌐 **Translation Proxy** — Built-in translation service proxy for multi-language support
|
|
- 🔧 **Provider Settings UI** — Easy-to-use settings page for managing providers
|
|
- 📦 **Debian Package** — Installable `.deb` package for Ubuntu/Debian
|
|
- 🖥️ **System Tray** — Minimize to system tray with status indicators
|
|
- 🔒 **Secure Storage** — Provider configurations stored locally and securely
|
|
|
|
## Quick Start
|
|
|
|
### Install from .deb
|
|
|
|
```bash
|
|
sudo dpkg -i ag-x_2.0.3_amd64.deb
|
|
sudo apt-get install -f # fix any missing dependencies
|
|
```
|
|
|
|
### First Run
|
|
|
|
1. Launch AG X from your application menu or run `ag-x`
|
|
2. On first launch, you'll see the **Welcome Screen**
|
|
3. Choose your provider:
|
|
- **Google OAuth** — Use the default Antigravity/Google authentication
|
|
- **Custom Provider** — Enter your own API endpoint URL and API key
|
|
4. Start using the app!
|
|
|
|
### Configure Provider
|
|
|
|
After initial setup, you can change your provider at any time:
|
|
- Click the AG X tray icon → **Settings**
|
|
- Or use the in-app provider settings
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
ag-x/
|
|
├── dist/ # Application source (compiled)
|
|
│ ├── main.js # Electron main process
|
|
│ ├── languageServer.js # Language Server proxy
|
|
│ ├── preload.js # Electron preload script
|
|
│ ├── providerSettings.js # Provider settings window
|
|
│ ├── provider/
|
|
│ │ ├── welcome.html # First-run welcome screen
|
|
│ │ └── settings.html # Provider settings page
|
|
│ ├── services/
|
|
│ │ ├── apiProxy.js # API request proxy
|
|
│ │ ├── providerService.js # Provider management
|
|
│ │ ├── translationProxy.js # Translation proxy
|
|
│ │ └── settingsService.js # Settings persistence
|
|
│ └── ...
|
|
├── releases/
|
|
│ └── ag-x_2.0.3_amd64.deb # Debian installer package
|
|
├── icon.png # Application icon
|
|
├── trayTemplate.png # Tray icon template
|
|
├── trayTemplate@2x.png # Tray icon template (Retina)
|
|
├── package.json # Node.js package manifest
|
|
├── CHANGELOG.md # Version history
|
|
└── README.md # This file
|
|
```
|
|
|
|
## Configuration
|
|
|
|
AG X stores configuration in:
|
|
- `~/.ag-x/ag-x/provider_config.json` — Provider settings
|
|
- `~/.codex/endpoints.json` — Language Server endpoint configuration
|
|
|
|
### Custom Provider Format
|
|
|
|
```json
|
|
{
|
|
"providerType": "custom",
|
|
"apiEndpoint": "https://your-api.example.com/v1",
|
|
"apiKey": "your-api-key",
|
|
"models": ["gpt-4", "gpt-3.5-turbo"]
|
|
}
|
|
```
|
|
|
|
## Building from Source
|
|
|
|
### Prerequisites
|
|
- Node.js 18+
|
|
- npm 9+
|
|
|
|
### Build Steps
|
|
|
|
```bash
|
|
npm install
|
|
npm run build
|
|
npm run package:linux
|
|
```
|
|
|
|
The `.deb` package will be in `releases/`.
|
|
|
|
## License
|
|
|
|
Fork of Antigravity. See original project for license details.
|
|
|
|
## Links
|
|
|
|
- **Repository**: [https://github.rommark.dev/admin/antigravity-ai-providers](https://github.rommark.dev/admin/antigravity-ai-providers)
|
|
- **Original**: Antigravity Desktop App
|