Skip to content

Setup ​

Install ​

bash
git clone https://github.com/grignolalouis/logidoc-server.git
cd logidoc-server
cp .env.example .env

Edit .env:

env
LLM_PROVIDER=anthropic
LLM_MODEL=claude-haiku-4-5-20251001
LLM_API_KEY=sk-ant-your-key

Start:

bash
docker compose up --build

LLM Providers ​

Set LLM_PROVIDER and LLM_MODEL in .env:

ProviderLLM_PROVIDERLLM_MODEL example
Anthropicanthropicclaude-haiku-4-5-20251001
OpenAIopenaigpt-4o-mini
Mistralmistralmistral-large-latest
xAIxaigrok-2
Groqgroqllama-3.3-70b-versatile
Ollamaollamallama3.2

Custom OpenAI-compatible endpoint: set LLM_BASE_URL.

Vision Model ​

By default, the main LLM handles everything (structure detection + vision tasks). For better results on tables and images, configure a separate vision model:

env
VISION_PROVIDER=openai
VISION_MODEL=gpt-4o-mini
VISION_API_KEY=                    # uses LLM_API_KEY if empty

The vision model is used for:

  • Table extraction via VLM (INDEXER_ENABLE_TABLE_EXTRACTION=true)
  • Image description (INDEXER_ENABLE_IMAGE_DESCRIPTION=true)

If VISION_PROVIDER is not set, the main LLM is used for everything.

Indexer Options ​

VariableDefaultDescription
INDEXER_MAX_PAGES_PER_NODE20Subdivide sections larger than this
INDEXER_ENABLE_TABLE_EXTRACTIONfalseVLM fallback for garbled tables
INDEXER_ENABLE_IMAGE_DESCRIPTIONfalseExtract and describe images

API Key Auth ​

Optional. Set API_KEY in .env to protect /v1/* endpoints:

env
API_KEY=sk-logidoc-your-secret

Then pass Authorization: Bearer sk-logidoc-your-secret in requests.

Health (/health), version (/version), and UI (/ui) are always public.

Ports ​

VariableDefaultDescription
HTTP_ADDR:7042HTTP API + UI
MCP_ADDR:7043MCP server
HTTP_PORT7042Docker host mapping
MCP_PORT7043Docker host mapping
MONGO_PORT27042MongoDB host mapping

All Environment Variables ​

VariableDefaultRequired
LLM_PROVIDERopenaiyes
LLM_MODELgpt-4oyes
LLM_API_KEY—yes
LLM_BASE_URL—no
VISION_PROVIDER—no
VISION_MODEL—no
VISION_API_KEYLLM_API_KEYno
VISION_BASE_URL—no
MONGO_URImongodb://localhost:27017no
MONGO_DATABASElogidocno
API_KEY—no
LOG_LEVELinfono
LOG_FORMATjsonno
HTTP_RATE_LIMIT100no
HTTP_BODY_LIMIT_MB50no
INDEXER_MAX_PAGES_PER_NODE20no
INDEXER_ENABLE_TABLE_EXTRACTIONfalseno
INDEXER_ENABLE_IMAGE_DESCRIPTIONfalseno

Released under the MIT License.