Modules Catalog
This catalog follows the current TramAI repository inventory exposed by the TramAI MCP.
Today that inventory contains 41 framework modules plus 4 reference examples.
The important thing is not the raw count. It is the compatibility split:
- the 0.4.0 release-line foundations that most consumers start with
- the runtime and transport modules that extend orchestration into server, MCP, scheduling, and platform flows
- the sovereign and security modules that are implemented, but still evolving quickly
- the reference examples used to exercise end-to-end scenarios
Start Here
For a normal JVM application, begin with:
dependencies {
implementation(platform("dev.tramai:tramai-bom:0.4.0"))
implementation("dev.tramai:tramai-standalone") // or tramai-spring
implementation("dev.tramai:tramai-openai") // or another provider
}
Add tramai-testing for tests, tramai-observability for telemetry, and tramai-orchestration when the work is multi-step.
Release-Line Foundations
These are the modules that anchor the main 0.4.0 developer experience described across the site.
| Group | Modules | Purpose |
|---|---|---|
| Core contracts | tramai-core, tramai-engine, tramai-structured, tramai-bom | Annotations, execution, structured output, version alignment |
| Application entry points | tramai-standalone, tramai-spring | Framework-free and Spring Boot integration |
| Core providers | tramai-openai, tramai-anthropic, tramai-ollama | Provider adapters with the most direct getting-started path |
| Production support | tramai-observability, tramai-orchestration, tramai-testing | Telemetry, workflows, deterministic tests |
Detailed pages are available for those modules in this section of the site.
Provider And Context Modules
The current repository also includes dedicated provider and context modules beyond the basic getting-started path.
| Area | Modules |
|---|---|
| Additional providers | tramai-gemini, tramai-deepseek, tramai-bedrock, tramai-azure-openai, tramai-spring-boot-starter-local-provider-openai |
| Memory and context | tramai-memory, tramai-memory-store |
| Embeddings and RAG | tramai-embedding, tramai-rag, tramai-vectorstore-spi, tramai-vectorstore-chroma, tramai-vectorstore-pgvector |
These modules are part of the current framework story and should not be described as hypothetical or future-only work.
Runtime, Transport, And Platform Modules
These modules extend TramAI beyond typed interface calls into workflow execution surfaces and operational tooling.
| Area | Modules |
|---|---|
| Scheduling and workflow transport | tramai-scheduler, tramai-server, tramai-mcp |
| Operational layer | tramai-platform, tramai-dashboard |
Treat these as real, implemented modules. They are not "planned", but they do evolve faster than the narrowest core surface.
Sovereign And Security Modules
The sovereign/runtime docs exposed by the TramAI MCP show these modules as implemented or implemented-and-evolving. They should no longer be documented as roadmap-only.
| Area | Modules |
|---|---|
| Security core | tramai-security, tramai-sovereign |
| Persistence | tramai-persistence-file, tramai-persistence-jdbc |
| Spring Boot sovereign starters | tramai-spring-boot-starter-sovereign, tramai-spring-boot-starter-sovereign-persistence-file, tramai-spring-boot-starter-sovereign-persistence-jdbc |
| Ops starters | tramai-spring-boot-starter-sovereign-ops, tramai-spring-boot-starter-sovereign-ops-actuator, tramai-spring-boot-starter-sovereign-ops-micrometer, tramai-spring-boot-starter-sovereign-ops-observability, tramai-spring-boot-starter-sovereign-ops-rest |
For 0.4.x, the security story should be framed as preview/evolving, not absent. The sovereign profile is a distinct part of the current framework, not a speculative future module.
Reference Examples
The current MCP inventory also exposes four example applications:
examples:sovereign-document-intelligenceexamples:sovereign-offline-verificationexamples:spring-sovereign-starterexamples:support-agent
Those examples are useful for validation and integration testing, but they are not framework modules.
Practical Reading Order
- Start with
tramai-standaloneortramai-spring. - Pick one provider module.
- Add
tramai-testingandtramai-observability. - Add
tramai-orchestrationonly when the work is multi-step. - Add server, MCP, scheduler, platform, or sovereign modules only when your runtime needs them.
