Modules
Tramai is modular by design. Pick what you need.
Core Contracts
Runtime & Entry Points
tramai-engine
Runtime engine that turns annotated service interfaces into AI-backed proxies with retry, circuit-breaking, caching, and token budgeting.
tramai-orchestration
Multi-step workflow engine with checkpoint/resume, distributed worker support, and a declarative DSL.
tramai-spring
Spring Boot auto-configuration that wires Tramai's runtime, scans @AiService interfaces, discovers @AiTool beans, and binds tramai.* application properties.
tramai-standalone
Minimal framework-free entry point that wires core, engine, and structured output into a single Tramai.create<T>() call.
tramai-structured
Generates JSON schemas from Kotlin types, extracts and validates structured objects from LLM responses.
Governance & Security
tramai-security
Policy enforcement, DLP redaction, human-approval gates, hash-chained audit and evidence records for governed TramAI invocations.
tramai-sovereign
Secure embedded runtime profile that composes deny-by-default policy, approved-model registry, trust-zone routing and evidence pack generation.
Persistence
Providers
tramai-anthropic
Provider for Anthropic's Messages API (Claude models).
tramai-azure-openai
Provider for Azure OpenAI — deployment-based endpoints with dual API key / Entra ID authentication.
tramai-bedrock
Provider for Amazon Bedrock using the InvokeModel API.
tramai-deepseek
Provider for DeepSeek's OpenAI-compatible chat completion API.
tramai-gemini
Provider for Google Gemini API — translates TramAI's unified message model to Gemini's endpoints.
tramai-ollama
Provider for locally-hosted Ollama models via the Ollama chat API.
tramai-openai
OpenAI-compatible model provider with support for OpenAI API, Together AI, Groq, vLLM, and any /chat/completions endpoint.
Spring Boot Integration
tramai-spring-boot-starter
The single canonical Spring Boot starter — composes the standard and sovereign runtime integrations and selects between them with tramai.profile.
tramai-spring-boot-starter-local-provider-openai
Development starter that auto-configures a loopback OpenAI-compatible provider from tramai.providers.local-lab-provider.
tramai-spring-boot-starter-sovereign-ops
Sovereign operations core — approval and resume control plane, audit and suspended-invocation operations, audit outbox worker and resume worker.
tramai-spring-boot-starter-sovereign-ops-actuator
Actuator add-on for sovereign ops — read-only worker status endpoint and health indicators for the outbox and resume workers.
tramai-spring-boot-starter-sovereign-ops-micrometer
Micrometer add-on for sovereign ops — exports audit-outbox worker metrics when a MeterRegistry is present.
tramai-spring-boot-starter-sovereign-ops-observability
OpenTelemetry add-on for sovereign ops — exports audit-outbox worker spans and metrics when an OpenTelemetry bean is present.
tramai-spring-boot-starter-sovereign-ops-rest
REST add-on for sovereign ops — approval control-plane and inbox controllers plus an optional reviewer UI.
tramai-spring-boot-starter-sovereign-persistence-file
Sovereign add-on starter that wires encrypted file-backed persistence — approvals, continuations, audit, suspended invocations and the ops audit outbox.
tramai-spring-boot-starter-sovereign-persistence-jdbc
Sovereign add-on starter that wires JDBC-backed approvals, audit, outbox, worker leases and resume-credential custody.
tramai-spring-consumer-boundary
Internal build fixture — asserts that a consumer depending only on the published Spring artifact receives no provider adapters or SDKs.
tramai-spring-consumer-selective
Internal build fixture — compiles a Spring consumer against a selected subset of TramAI modules as API-compatibility evidence.
tramai-spring-core
Profile-neutral Spring integration core — runtime wiring, @AiService proxy registration, @AiTool scanning, secret resolution and tramai.* properties.
tramai-spring-provider-anthropic
Spring Boot auto-configuration for the Anthropic provider — binds tramai.providers.anthropic.* and registers an AnthropicProvider bean.
tramai-spring-provider-ollama
Spring Boot auto-configuration for the Ollama provider — binds tramai.providers.ollama.* and registers an OllamaProvider bean.
tramai-spring-provider-openai
Spring Boot auto-configuration for OpenAI and OpenAI-compatible providers — binds both property namespaces and registers provider beans.
tramai-spring-secrets-aws
[object Object]
tramai-spring-secrets-file
[object Object]
tramai-spring-secrets-vault
[object Object]
tramai-spring-sovereign
Spring Boot integration for the sovereign runtime — activates on tramai.profile=sovereign and wires the sealed, governed Tramai runtime into the context.
Operations & Observability
tramai-dashboard
Vue 3 admin UI for managing TramAI workflows, schedules, and workers.
tramai-mcp
Exposes registered Tramai workflows as MCP tools over stdio or SSE transport.
tramai-observability
Optional, opt-in OpenTelemetry integration — traces, metrics, and events for operations and workflows.
tramai-platform
Multi-tenant operational layer above the workflow server with API key authentication, rate limiting, audit logging, and a runtime plugin system.
tramai-scheduler
Time-based workflow triggers with cron expressions, delay wakeups, and a durable tick-claiming scheduler loop.
tramai-server
HTTP REST API surface for Tramai workflows — start, inspect, resume, cancel, and stream runs.
Memory, RAG & Embeddings
tramai-embedding
Text embedding generation.
tramai-memory
In-memory context and token-aware multi-turn conversational chat persistence.
tramai-memory-store
Durable ChatMemoryStore implementations (JDBC, Redis) for persistent conversation history.
tramai-rag
Retrieval-Augmented Generation context pipeline.
tramai-vectorstore-chroma
ChromaDB implementation of the vector store SPI.
tramai-vectorstore-pgvector
PostgreSQL pgvector implementation of the vector store SPI.
tramai-vectorstore-spi
Contract layer for vector database operations.