CitOmni HelloAi - Initial Release

CitOmni HelloAi - Initial Release

This is the first public release of CitOmni HelloAi.

citomni/helloai is a lean, deterministic provider package for chatbot APIs in the CitOmni ecosystem. It gives applications one compact internal contract for chat-style requests and responses, while keeping provider-specific translation localized to dedicated adapters.

Included in this release

• HelloAi service as the primary application-facing entry point
• Unified internal request/response format for chat-style API calls
• Profile-based configuration for adapter, model, endpoint, API key, and timeout selection
• Adapter-driven provider translation through a small explicit interface
• Anthropic adapter
• Dev adapter
• Deterministic DB-backed response caching
• Explicit package-level logging with secret sanitization
• CLI integration through helloai:chat
• Package-specific exception types
• Package bootstrap wiring for HTTP and CLI
• Documentation and package metadata, including README, LICENSE, and NOTICE

Architectural characteristics

• Reuses the existing CitOmni cURL service for outbound HTTP transport
• Keeps provider JSON translation in adapters
• Keeps SQL in the cache repository
• Uses profile-based configuration rather than provider branching in application code
• Avoids hidden fallback, retry, and model-routing behavior

Notes

HelloAi is intentionally narrow in scope. It is designed to provide a stable and reusable integration layer for chatbot APIs without turning into a broad, opaque AI framework.

CitOmni - low overhead, high performance, ready for anything.