Using External AI in MyRobot

main.md

Tutorial: Using External AI (like Gemini) in MyRobot via Fount

This guide explains how to connect a web-based AI API, such as Google Gemini, to the MyRobot game using the 'fount' application. This allows you to leverage powerful external AI services (which may be free or offer alternative capabilities) instead of relying solely on MyRobot's built-in options or running resource-intensive local models.

Prerequisites:

• MyRobot installed.
• A stable internet connection.
• The fount application (installation steps below).

---

Choosing Your AI Approach: Fount vs. Local LLM

Before you begin, it's helpful to understand the differences between using fount with an external AI and running a Large Language Model (LLM) locally on your computer:

Feature	Fount (with External AI)	Local LLM
Disk Space	~200 MB (for fount)	4-5 GB+ (depending on model size)
Intelligence	Potentially higher (access to powerful online models like Gemini).	Varies by model; often sufficient for basic conversation but typically less capable than top-tier online models.
Running Requirements	Requires a stable internet connection; very low local resource usage (CPU/RAM).	Works offline; Requires significant VRAM (GPU memory) and GPU processing power for good performance.
Configuration	Slightly more complex setup (API keys, fount config), but generally straightforward.	Varies; initial setup can be simpler but often involves downloading large model files.

In summary: Use fount if you have a reliable internet connection and want access to potentially more powerful AI without heavily taxing your own hardware. Use a local LLM if you need offline capability or prefer a self-contained solution, provided your computer has sufficient VRAM and GPU power. This guide focuses on the fount method.

---

Step 1: Install and Run Fount

1. Download and install the fount application from its official repository: https://github.com/steve02081504/fount

   • The installation typically requires about 200MB of disk space.

2. Once installed, launch the fount application.

3. Important: Fount must remain running in the background while you intend to use the external AI connection in MyRobot.

   

Step 2: Configure Your AI Source in Fount

1. In the running fount application, find and click on Manage AI Sources. This option is usually located in the upper right corner of the main window.

   

2. Click the New button (or a similar option like "Add") to create a configuration for your external AI service.

   • Note on OpenAI-Compatible Sources: If your AI provider offers an OpenAI-compatible API endpoint, you can use proxy generator.

3. Fill in the required details for your chosen AI service:

   • Name: Assign a clear and memorable name (e.g., gemini-free, my-cohere-api). You will need this exact name later.
   • API Key: Enter the API key provided by your AI service. Treat this key like a password and keep it secure.
   • Other Settings: Configure any additional fields as required by the specific AI provider (e.g., API endpoint URL, model selection if applicable).
   • Looking for a Free AI Source? You can often obtain free API keys from services like:
     • Google AI Studio (for Gemini)
     • Cohere
     • Follow the instructions on their websites to generate your key. These are excellent options to start with, and we highly recommend trying them.

   

4. Save the AI source configuration within fount.

Step 3: Configure MyRobot to Use Fount

1. Ensure the fount application is still running in the background.

2. Launch MyRobot and enter the game world.

3. Press the ESC key to open the main menu or settings panel.

4. Navigate to the section for AI Source Settings (the exact menu name might vary slightly).

5. In the input field labeled for the AI source address, endpoint, or URL, enter the following URL structure:

   http://localhost:8931/asuser/<your_fount_username>/api/shells/proxy/calling/openai/models/<your_fount_AI_source_name>
   

6. Crucially, you MUST replace the placeholders:

   • Replace <your_fount_username> with your actual username registered or used within the fount application.
   • Replace <your_fount_AI_source_name> with the exact Name you assigned to your AI source in fount during Step 2 (e.g., gemini-flash).

7. Example: If your fount username is steve02081504 and you named your AI source freeuse in Step 2, the complete URL you would enter in MyRobot is:

   http://localhost:8931/asuser/steve02081504/api/shells/proxy/calling/openai/models/freeuse
   

   (Note: localhost refers to your own computer where fount is running).

8. Apply or save these settings within MyRobot.

---

Completion:

That's it! If everything is configured correctly, MyRobot will now send its AI requests to the running fount application. Fount will then relay these requests to the external AI service (like Google Gemini) you configured, using your API key.

Troubleshooting Tip: If it doesn't seem to work, double-check the following:

• Is fount running?
• Is the URL entered exactly correct in MyRobot, including your fount username and the AI Source Name?
• Is your internet connection active?
• Did you save the AI Source configuration correctly in fount, including a valid API key?

Enjoy using your chosen external AI in MyRobot!

P.S.

Thanks to the MyRobot developers! :)