Skip to main content

Installation instructions

The details of installing Ludus AI vary depending on the IDE. Below you will find instructions for installing Ludus AI in Cursor, Rider, VS, and VS Code. Ludus AI is not affiliated with Cursor, Rider, VS or VS Code. We do not take any responsibility for the quality of the service.

Cursor installation guide​

  1. Open File -> Preferences -> Cursor Settings.
  2. Manually add "ludus-full" to the list of models.
  3. Navigate to the section for OpenAI settings.
  4. Use the API URL and API Key provided above as the OpenAI custom URL and API Key.
  5. During verification, disable all models except "ludus-full".
  6. Click the verify button to check if the settings are valid.
  7. You can now use Ludus AI via Cursor. You can also enable other models if desired. Note that GPT-4o and other models provided by OpenAI will not work.

Rider installation guide​

  1. Install Proxy AI from JetBrains Marketplace.
  2. Navigate to Settings -> Tools -> ProxyAI -> Providers -> Custom OpenAI.
  3. Select the Preset template "OpenAI".
  4. Set the name you desire for the new profile.
  5. Paste in the API key copied from above into the "API key" field.
  6. In the section "Chat Completions" paste in the URL copied from above.
  7. Under the URL navigate to section "Body" and change the model to "ludus-full" or "ludus-lite".
  8. Delete the whole entry with name "max_tokens" - not only numbers.
  9. Start coding!

VS installation guide​

  1. Download and install Ludus AI extension from the Visual Studio Marketplace.
  2. Go to 'Tools' -> 'Options' -> 'Ludus AI'.
  3. Set your API key in 'Ludus API Key'.
  4. Set 'Ludus Model' to either 'ludus-full' or 'ludus-lite'.
  5. Open the extension via 'View' -> 'Other Windows' -> 'Ludus AI'.
  6. Start coding!

VS code installation guide​

  1. Install Roo Code extension from the VS Code Marketplace.
  2. Open the extension settings (cog icon in the top right corner of the extension).
  3. Create new Configuration Profile.
  4. As API Provider select 'OpenAI Compatible'.
  5. Paste in the Base URL from the above.
  6. Paste in the OpenAI API Key copied from above.
  7. Select one of the available models (e.g., "ludus-full", "ludus-lite" followed by the knowledgebase version).
  8. Enable 'Use legacy OpenAI API format'.
  9. Make sure image, computer use, prompt caching is disabled.
  10. Click 'Save' at the top, then 'Done'.
  11. At the bottom select the mode you wish and configuration profile you created before.

It may also happen that the rules for using plugins in Rider and VS Code that allow Ludus to be added to supported AI will change, making their use impossible or their service temporarily unavailable. In such a situation, it is worth waiting a while to see if the situation has changed and report the problem to support@ludusengine.com.