Quick Start

Get Interpretos Local running on your machine in under 10 minutes. Free tier included — no API key required.

Docker & Docker Compose v2+ Oracle EBS 12.2 database access (SSH or direct)
1

Create docker-compose.yml

Create a new directory and save this file as docker-compose.yml:

docker-compose.yml
services: ebs-assistant: image: interpretos/local:latest ports: - "${CDDI_PORT:-8080}:5000" volumes: - ebs-data:/app/data environment: - CDDI_INTEGRATION=oracle_ebs - CDDI_TELEMETRY=false - CDDI_LLM_PROXY_URL=https://llm.interpretos.com/v1 restart: unless-stopped volumes: ebs-data:
Default port: 8080 Change the port with CDDI_PORT=9090 docker compose up -d
2

Start the container

Terminal
docker compose up -d

Docker pulls the image and starts the assistant. This takes 1–2 minutes on first run.

3

Run the setup wizard

Open your browser:

Browser
http://localhost:8080

The setup wizard walks you through:

  1. Admin account — Username, password, EULA acceptance
  2. AI provider — Interpretos Cloud (free, default) or bring your own key
  3. Telemetry — Opt in or out (disabled by default)
  4. Database connection — SSH host + credentials, or direct Oracle connection
  5. Review & complete
No API key needed Interpretos Cloud is selected by default — 100 free queries per day, no credit card. Your questions go through our LLM proxy; no EBS data is stored.
4

Ask a question

Once the wizard completes, you land on the chat UI. Try:

Example queries
What is the status of PO 1001? Show me recent AP invoices What inventory items are on hand in org 204? How many open purchase orders do we have?

The assistant connects to your EBS database and returns live data. Typical response time: 9–15 seconds.

Air-Gapped Mode (optional)

For fully air-gapped operation with zero external network calls:

  1. Run a local LLM (e.g. Ollama, vLLM, or any OpenAI-compatible server)
  2. During setup, select Custom / Self-hosted and enter your local endpoint (e.g. http://your-server:11434/v1)
  3. Set CDDI_TELEMETRY=false in your docker-compose.yml (already the default)
Complete isolation In this configuration, the container never contacts any Interpretos server. Your data, your LLM, your network.

What's Next

EBS User Login (RBAC)

Click the EBS Login bar in the chat UI and enter your Oracle EBS credentials. Queries will be restricted to your authorized operating units.

Admin Panel

Click the gear icon to manage users, change AI provider, view the audit log, and check for pattern updates.

Supported Modules

PO, AP, AR, GL, INV, ONT — 23+ query patterns across 6 EBS modules. See all modules.

Need Help?

Check the product page or contact us for support, custom patterns, or enterprise inquiries.