Overview
Interactive setup for text embeddings: provider (Ollama, OpenAI, or Cohere), model from a curated list, and API key for cloud providers. Settings are written to ~/.moorcheh/config.json and used on every moorcheh up.
You can run this before or instead of answering prompts during the first moorcheh up.
Synopsis
moorcheh configure [--force]
Options
| Flag | Description |
|---|
--force | Re-run the wizard even if config.json already exists |
What it asks
- Provider —
ollama, openai, or cohere (default in wizard: openai)
- Model — numbered menu per provider (see Embedding providers)
- API key — required for
openai and cohere (hidden input); not asked for ollama
base_url is saved from release defaults (edit config.json to point at a proxy or alternate endpoint).
Ollama-specific behavior
| Situation | What happens |
|---|
Ollama already running on http://127.0.0.1:11434 | Checks for the model; offers to pull if missing |
| Ollama not running | Saves config; tells you model will be pulled on next moorcheh up |
moorcheh up for that.
Examples
# First-time setup
moorcheh configure
# Change provider or model
moorcheh configure --force
# Then start the stack
moorcheh up
Config file example
{
"provider": "openai",
"model": "text-embedding-3-small",
"api_key": "sk-...",
"base_url": "https://api.openai.com/v1"
}
On Unix, config.json is created with mode 600. Do not commit this file or share it; it may contain API keys.
Non-interactive overrides
You can skip the wizard and set values on moorcheh up:
moorcheh up --embedding-provider cohere --embedding-model embed-v4.0 --embedding-api-key "$COHERE_API_KEY"
--no-configure after config.json exists.
