⛎ SurrealDB Integration v0.2.9

SuperOptiX v0.2.9 - SurrealDB Integration

This release adds first-class SurrealDB support for SuperOptiX RAG workflows and framework demos.

Added

• Native surrealdb retriever support in runner-managed RAG.
• SurrealDB vector store adapter for GEPA RAG.
• SuperSpec schema and validator support for surrealdb retriever type.
• New SurrealDB demo agents:
  • rag_surrealdb_demo (embedded/local)
  • rag_surrealdb_docker_demo (Docker/auth mode)
  • rag_surrealdb_pydanticai_demo
  • rag_surrealdb_crewai_demo
  • rag_surrealdb_adk_demo
• New SurrealDB docs:
  • Embedded demo guide
  • Docker demo guide
  • Framework guide for DSPy, PydanticAI, CrewAI, and Google ADK

Improved

• Minimal pipeline templates now inject retrieved RAG context for:
  • PydanticAI
  • CrewAI
  • Google ADK
• Better SurrealDB URL handling and auth mode behavior for embedded and server setups.
• Beginner-friendly framework documentation and troubleshooting flow.

Validation

• Added tests for SurrealDB vector store behavior:
  • tests/test_surrealdb_vector_store.py

Notes

• provider: ollama controls generation model.
• embedding_model: sentence-transformers/all-MiniLM-L6-v2 is used for embeddings and may download once on first
  run, then use local cache.