aurask/api/README.md

Aurask API

This directory contains the Python backend package and bridge configuration for:

• PostgreSQL
• PGVector
• Redis
• AnythingLLM
• Langflow
• Frontend-to-backend request contracts

Runtime modes

Default local mode uses JsonStore and simulated bridges:

uv run aurask demo --reset
uv run aurask serve --reset --host 127.0.0.1 --port 8080

Production bridge mode can be enabled with:

$env:AURASK_USE_EXTERNAL_BRIDGES="true"
$env:AURASK_DATABASE_URL="postgresql://aurask:secret@postgres:5432/aurask"
$env:AURASK_REDIS_URL="redis://redis:6379/0"
$env:AURASK_ANYTHINGLLM_BASE_URL="http://anythingllm.aurask-runtime.svc.cluster.local:3001"
$env:AURASK_ANYTHINGLLM_API_KEY="<secret>"
$env:AURASK_LANGFLOW_BASE_URL="http://langflow-runtime.aurask-runtime.svc.cluster.local:7860"
$env:AURASK_LANGFLOW_API_KEY="<secret>"
uv run aurask serve --host 0.0.0.0 --port 8080

Bridge modules

• aurask.bridges.config: environment-driven configuration
• aurask.bridges.postgres: PostgreSQL schema contract
• aurask.bridges.pgvector: PGVector tenant-filtered collection contract
• aurask.bridges.redis_bridge: Redis queue/cache/idempotency key contract
• aurask.bridges.anythingllm: AnythingLLM API bridge
• aurask.bridges.langflow: Langflow runtime bridge

Admin bridge status

Authenticated admin status endpoint:

GET /admin/bridge-status
Authorization: Bearer <api_key>