This version is still in development and is not considered stable yet. For the latest stable version, please use Spring AI 2.1.0!

Contribution Guidelines

Code Formatting and Javadoc

Before submitting a PR, format the sources and check the Javadoc:

./mvnw process-sources
./mvnw javadoc:javadoc

Local builds also format the sources automatically. See CONTRIBUTING.md for the code style and the other build commands.

Contributing a New AI Model Implementation

This section outlines the steps for contributing a new AI model implementation. AI models vary significantly, with diverse inputs and outputs — from chat models that translate text input into text output, to text-to-image models that generate images from text descriptions. Complex models may even handle multiple types of input and output, such as combining text, images, and videos to produce mixed media output.

To contribute a new model, adhere to the following steps:

  1. Create a Low-Level Client API Class: If no existing Java client suits the AI model, you’ll need to develop a low-level client API class. This often involves utilizing the RestClient class from the Spring Framework, similar to the MistralAiApi class.

  2. Create a Model implementation Ensure your client conforms to the Generic Model API. Use existing request and response classes if your model’s inputs and outputs are supported. If not, create new classes for the Generic Model API and establish a new Java package. Do not log prompts, completions or other content that can contain personal data by default.

  3. Implement Auto-Configuration and a Spring Boot Starter: This step involves creating the necessary auto-configuration and Spring Boot Starter to easily instantiate the new model with Spring Boot applications.

  4. Write Tests: All new classes should be accompanied by comprehensive tests. Existing tests can serve as a useful reference for structuring and implementing your tests.

  5. Document Your Contribution: Ensure your documentation follows the existing format, For an example of the suggested structure and formatting, refer to the Open AI Chat documentation.

By following these guidelines, we can greatly expand the framework’s range of supported models while following a common implementation and documentation pattern.