chandralegend/sofia-base repository overview

⁠Sofia Base Image

Official base image for building SOFIA (Simple Orchestrated Flow Intelligence Agent) agents.

⁠Features

• Pre-installed SOFIA agent framework
• Configurable via environment variables or mounted config files
• Built-in support for OpenAI, Mistral, and Gemini LLMs
• FastAPI-based HTTP and WebSocket endpoints
• Redis support for session management
• SQLModel-based persistent storage
• Session management with support for both Redis and PostgreSQL

⁠Quick Start

docker pull chandralegend/sofia-base:latest

Create a Dockerfile:

FROM chandralegend/sofia-base:latest
COPY config.agent.yaml /app/config.agent.yaml

⁠Configuration Options

⁠Using URL Configuration

docker run -e OPENAI_API_KEY=your-key \
          -e CONFIG_URL=https://example.com/config.yaml \
          -p 8000:8000 your-image

⁠Using Local Configuration

docker run -e OPENAI_API_KEY=your-key \
          -v $(pwd)/config.agent.yaml:/app/config.agent.yaml \
          -p 8000:8000 your-image

⁠Environment Variables

⁠Storage Options

⁠Redis Session Store

Enable Redis session storage by setting the REDIS_URL environment variable:

docker run -e REDIS_URL=redis://redis:6379/0 ...

⁠PostgreSQL Database

Enable persistent storage by setting the DATABASE_URL environment variable:

docker run -e DATABASE_URL=postgresql+asyncpg://user:pass@localhost/dbname ...

⁠API Endpoints

• POST /session - Create a new session
• POST /session/{session_id}/message - Send a message to a session
• WS /ws/{session_id} - WebSocket connection for real-time interaction
• DELETE /session/{session_id} - End a session
• GET /session/{session_id}/history - Get session history

⁠Tags

• latest: Most recent stable version
• x.y.z: Specific version releases

⁠GitHub Repository

For more information, visit SOFIA GitHub Repository⁠

⁠License

MIT License