Easy8 AI Basic with cloud AI

Use this guide for Easy8 AI Basic with an LLM from a cloud service such as OpenAI or Azure OpenAI. Basic needs no ChromaDB and no embeddings service.

Before you start, read Prerequisites.

Environment configuration

Set the variables from Common configuration, then add one cloud LLM configuration.

You can leave EASY_AI_PUBLIC_URL, EASY_AI_CHAIN_HOST, EASY_AI_CHAIN_PORT and EASY_AI_CHAIN_URL unset; see Easy8-to-Chain URLs.

OpenAI:

OPENAI_API_KEY=sk-...

Azure OpenAI:

AZURE_OPENAI_API_KEY=...
AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com/

Installation steps

1. Add the environment variables to the Easy8 .env file.
2. Check that the package includes docker-compose_easy_ai.yml.

3. Install and start Easy8:

   docker compose run --rm app install
   docker compose up -d
   

4. Add the reverse proxy rule from Nginx configuration. Browser requests must reach Chain through /ai/chain. Without the rule, activation fails with 404 errors on /ai/chain/api/... even when the variables are correct.

5. Check that app, chain, celery and redis are running.

6. Open both public Chain URLs:

   • https://your.easy.host/ai/chain/sys/monitoring.json
   • https://your.easy.host/ai/chain/api/info

See Verification and troubleshooting.

Notes

• chroma is in the package compose, but Basic does not use it.
• Without a configured LLM provider, Chain starts but the Basic AI features do not work.
• A 404 on /ai/chain/api/... usually means a reverse proxy or public URL problem, not a JWT secret mismatch.