Skip to main content

Gotchas: helvia-rag-pipelines

Package-specific non-obvious patterns and pitfalls. Loaded on demand when working on this package.

  • Completely independent JWT system: Different secret (JWT_SECRET vs hbf-core's app.security.token.secret), different validation (local vs remote). Tokens are NOT interchangeable with hbf-core tokens.
  • uvicorn entry point is app.main:fast_api_app: Not main:app. The FastAPI instance is named fast_api_app in app/main.py.

CI/CD​

  • Isolved production deploy bug (HAP-77): The isolved production deploy step in ci.yml uses refs/heads/staging instead of refs/heads/main. Isolved production has never been updated from main.