FAQ

Which modules do I need for a simple agent?

tnsai-core plus tnsai-llm. Core gives you the agent runtime (roles, actions, capabilities, tool dispatch), and LLM gives you the provider clients (Anthropic, OpenAI, Gemini, Ollama, and the others: see the LLM provider matrix, or tnsai-llm README on GitHub). Everything else (channels, MCP, intelligence, coordination, quality, evaluation) is opt-in once you actually need the capability.

→ Module Overview for the full map.

Can I use TnsAI without annotations?

Yes. AgentBuilder accepts every part of the agent configuration programmatically (roles, tools, LLM clients, capabilities), so you can wire things up entirely from code if your project doesn't want annotation-driven discovery. Annotations are idiomatic and shorter, but they're not load-bearing for the runtime.

→ Reference → Annotations for the full reference.

Does TnsAI require Java 21?

Yes. The framework leans on virtual threads, records, sealed types, and switch-on-sealed pattern matching that all landed in Java 21 LTS. The toolchain (Maven compiler plugin, surefire) is pinned to release 21. There's no LTS-bridging build profile, and one isn't planned.

Is TnsAI production-ready?

The framework is pre-1.0, which means the public API can shift between minor versions and there are no long-lived @Deprecated shims. A release can carry breaking changes; the upgrade guide lists each one and what to change, with an OpenRewrite recipe where one exists. If your project can't absorb an occasional upgrade step when a minor version lands, hold off until 1.0.

In practice: read the changelog before bumping versions, and lean on the upgrade guide for releases that ship breaking changes.

More questions?

If a question keeps coming up that isn't covered here, open a discussion and we'll add it. For bug reports use the issue tracker, and for "how do I..." questions discussions are the right home.