🤖 aigateway - Control Your AI API Traffic

---

📋 About aigateway

aigateway is a self-hosted tool that controls how your AI services work with different clients. It helps you set up limits for use, choose which AI models each client can access, and watch activity with an easy dashboard. It works with providers like Gemini, OpenAI, Anthropic, Ollama, and LM Studio.

With aigateway, you can:

• Manage who uses which AI provider.
• Set rules on requests with rate limits and quotas.
• Pick specific AI models clients can use.
• Watch usage live in a dashboard.
• Keep control over multiple AI services from one place.

You do not need to be a programmer to use it. Just follow the steps below to get started on Windows.

---

🚦 System Requirements

Before installing, make sure your PC matches these needs:

• Windows 10 or newer (64-bit recommended)
• At least 4 GB of RAM
• 1 GHz or faster processor
• 500 MB of free disk space
• An active internet connection for setup and updates
• A web browser (Chrome, Edge, Firefox) to access the dashboard

---

📥 How to Download aigateway

To get started, you will download the latest version of aigateway from its official GitHub page.

Visit this page to download the software:

Steps to download:

1. Click the green "Code" button near the top right of the GitHub page.
2. Choose "Releases" from the menu or go straight to the Releases section on the right.
3. Find the latest stable release.
4. Download the .exe installer file marked for Windows.
5. Save the file to your desktop or downloads folder.

---

🛠️ Installing aigateway on Windows

Follow this guide to install the software properly:

1. Locate the downloaded .exe file.
2. Double-click the file to start the installer.
3. If Windows asks for permission, click Yes to allow the installer to run.
4. Follow the setup wizard instructions on the screen:
   • Choose the installation folder or keep the default location.
   • Click Next to move through the steps.
5. When the install finishes, click Finish to exit the wizard.

No special setup is needed at this point. Ready to run the program.

---

🚀 Running aigateway for the First Time

Once installed, run the application to set up your AI API gateway.

1. Find the aigateway icon on your desktop or in the Start menu.
2. Double-click to launch the program.
3. The first time you open it, the dashboard will load in your web browser.
4. The dashboard lets you:
   • Connect your AI providers.
   • Configure clients and their permissions.
   • Set rate limits and quotas.
   • Monitor API calls in real time.

You do not need to write code. Use the menu and forms to enter settings.

---

⚙️ Basic Configuration Guide

Here’s what you need to do inside the dashboard:

1. Add AI Providers:
   Input your API keys for Gemini, OpenAI, Anthropic, Ollama, or LM Studio. This links your account to the gateway.

2. Set Up Clients:
   Create entries for each client or application that will use your AI API. Give each a name and select which providers and models they can use.

3. Control Access:
   Use the Access Control List (ACL) to allow or deny specific clients. The gateway checks these rules on every request.

4. Apply Rate Limits:
   Limit how many API calls each client can make. You can choose daily or monthly quotas to manage usage and costs.

5. Monitor Usage:
   View live data in the real-time dashboard to see request volume, errors, and performance.

---

🔒 Security and Privacy Tips

To keep your gateway secure:

• Use strong, unique API keys for your AI providers.
• Restrict access to the dashboard with passwords or IP filtering.
• Regularly update to the latest version of aigateway.
• Back up your configuration settings regularly.
• Monitor dashboard alerts for unusual activity.

---

💡 Troubleshooting Common Issues

If you encounter problems, try these solutions:

• Cannot open installer:
  Make sure you have permission on your PC. Run as Administrator by right-clicking the .exe and choosing "Run as administrator."

• Dashboard does not load:
  Check that your browser is up to date and your firewall allows the app to access the internet.

• API connection errors:
  Confirm your provider API keys are entered correctly and active.

• Slow response or hangs:
  Restart the app and check your internet connection. Ensure your PC meets system requirements.

---

🔄 Updating aigateway

To update:

1. Check the GitHub page regularly for new releases.
2. Download the latest installer file.
3. Run the installer to overwrite the old version.
4. Your settings and data will stay intact.

---

🗂️ More Information and Support

For further help or information, visit the GitHub repository page here:

https://github.com/marouchsail/aigateway

The repository includes detailed documentation, issue tracking, and community discussions.

---

📁 File Structure Overview (Optional)

• aigateway.exe - The main Windows executable file.
• config/ - Folder storing your configuration files.
• logs/ - Folder with logs of requests and errors.
• dashboard/ - Front-end files for the web dashboard.
• README.md - This file with instructions.

---

🔧 Useful Tips

• Always keep a backup of your config files before making big changes.
• Use the dashboard to adjust your setup without reinstalling.
• Test your client connections using small requests.
• Check rate limits frequently to avoid lost requests.