Adding Agent

This guide explains how to add support for a new AI provider in Quotio. Since Quotio uses CLIProxyAPI as the backend, new providers are typically added to CLIProxyAPI first.

Prerequisites

• Go toolchain installed (for CLIProxyAPI development).
• Access to the target Provider's API documentation.
• A test API key for the provider.

Implementation Steps

1. Contribute to CLIProxyAPI

Most provider integrations happen in the CLIProxyAPI repository:

1. Fork CLIProxyAPI
2. Add the new provider support
3. Test the integration
4. Submit a pull request

2. Update Quotio Frontend (if needed)

Once CLIProxyAPI supports the new provider, update Quotio's UI:

1. Add the provider to AIProvider enum in Models.swift
2. Update UI strings in LanguageManager.swift
3. Add provider icon if needed

3. Update Quotio (if applicable)

If the provider requires special handling in Quotio:

1. Add provider to AIProvider enum in Models.swift
2. Update localized strings in LanguageManager.swift
3. Add provider icon asset
4. Test provider selection and configuration flow

Testing

1. Test the provider integration in CLIProxyAPI
2. Verify OAuth flow works correctly
3. Test quota tracking and failover
4. Ensure provider appears correctly in Quotio UI

Next Steps

Review the contribution guidelines before submitting a Pull Request.

Contributing