Summary
There is currently no documentation or guide for migrating between model providers in Spring AI. For example, switching from spring-ai-starter-model-openai to spring-ai-starter-model-ollama requires changes across dependencies, configuration properties, and potentially prompt templates — but there's no centralized resource explaining the steps.
Context
I recently migrated my microservice from OpenAI to Ollama. The process involved:
- Swapping the Maven dependency (
spring-ai-starter-model-openai → spring-ai-starter-model-ollama)
- Updating
application.yaml properties (model name, base URL, embedding config)
- Adjusting prompt templates for differences in model behavior
- Handling differences in streaming response formats
While each step is individually documented, there's no unified migration guide that walks through provider switching end-to-end.
Proposal
Add a documentation page (or section within existing docs) covering:
- Common migration paths (OpenAI ↔ Ollama, OpenAI ↔ Azure OpenAI, etc.)
- Dependency changes required
- Configuration property mappings between providers
- Known behavioral differences (e.g., streaming, token counting, embedding dimensions)
- A checklist for verifying the migration
Why this matters
As teams evaluate cost, latency, and data privacy trade-offs, switching model providers is a common need. A migration guide would significantly reduce friction for adopters.
Spring Boot version: 4.0.2
Spring AI version: 2.0.0-M2
Summary
There is currently no documentation or guide for migrating between model providers in Spring AI. For example, switching from
spring-ai-starter-model-openaitospring-ai-starter-model-ollamarequires changes across dependencies, configuration properties, and potentially prompt templates — but there's no centralized resource explaining the steps.Context
I recently migrated my microservice from OpenAI to Ollama. The process involved:
spring-ai-starter-model-openai→spring-ai-starter-model-ollama)application.yamlproperties (model name, base URL, embedding config)While each step is individually documented, there's no unified migration guide that walks through provider switching end-to-end.
Proposal
Add a documentation page (or section within existing docs) covering:
Why this matters
As teams evaluate cost, latency, and data privacy trade-offs, switching model providers is a common need. A migration guide would significantly reduce friction for adopters.
Spring Boot version: 4.0.2
Spring AI version: 2.0.0-M2