Viindoo AI
The foundation layer of the Viindoo AI cluster. Connect your Odoo database to any
LLM vendor - OpenAI, Anthropic, Google Gemini, OpenRouter, xAI, Mistral, Cohere,
DeepSeek, Qwen, Groq, Together AI, Perplexity, Ollama, Azure OpenAI - and keep
spending, audit, and privacy fully under your control.
Install this module first. Higher-layer Viindoo AI modules (RAG, Agent, Chat,
Search) add capabilities on top; they all rely on the provider, cost, and
observability primitives shipped here.
Key Features
- 14 AI vendors pre-configured - a viin.ai.vendor brand catalog (14
vendors) and ~50 flagship models seeded out of the box, including context
windows and US-dollar pricing. Admin only needs to paste an API key to start
using. Catalog snapshot documented at
viin_ai/docs/provider_model_catalog.md.
- Per-user and per-company spending limits - set a soft warning and a hard
cap in US dollars per user per day or per company per day. Requests that
would exceed the hard cap are blocked cleanly, with a user-friendly error.
- Two-layer observability - every AI request produces a usage log (one
row per call) and optionally a trace (multiple calls grouped into one
end-to-end interaction). Users can rate answers thumbs-up / thumbs-down /
flag for review; admins see spending by user, by agent, by day.
- Personal-data protection - when the Privacy Redaction switch is on, the
module automatically masks email addresses, phone numbers, Vietnamese
personal ID (CCCD), and bank account numbers before sending text to the
vendor, and before writing request/response snapshots to the database.
- Data residency control - every provider record declares where the
vendor processes data (EU, US, APAC, self-hosted). Use this to pick
GDPR-aligned providers for EU customer data, or self-hosted Ollama for
air-gapped deployments.
- HTTP layer with audit trail - every outbound request is persisted via
the api.request.mixin library: request method/URL/body, response
status/body, duration, and correlation with the usage log via Trace ID.
API keys are auto-masked in the audit trail.
Supported Editions
- Community Edition
- Enterprise Edition
This software and associated files (the "Software") may only be
used
(executed, modified, executed after modifications) if you have
purchased a
valid license from the authors, typically via Odoo Apps,
or if you
have
received a written agreement from the authors of the
Software (see the
COPYRIGHT file).
You may develop Odoo modules that use the Software as a library
(typically
by depending on it, importing it and using its
resources), but
without
copying any source code or material from the
Software. You may distribute
those modules under the license of your
choice, provided that this
license
is compatible with the terms of
the Odoo Proprietary License (For
example:
LGPL, MIT, or proprietary
licenses similar to this one).
It is forbidden to publish, distribute, sublicense, or sell
copies of the
Software or modified copies of the Software.
The above copyright notice and this permission notice must be
included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT
SHALL THE
AUTHORS OR COPYRIGHT HOLDERS
BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN
ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING
FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE
SOFTWARE.
