How pr0xiuss/hypoquery works
HypoQuery appears to be a SQL optimization platform with a database-connection UI and backend optimization, ingestion, knowledge, and assistant capabilities. The clearest documented runtime workflow is optimization-pipeline construction: a builder registers processing nodes and defines their order. Ingestion separately collects executions, queues them, and dispatches workers. The README gives no capability details, and many central modules are indexed but unsampled; their nodes are included where the tree supports them, but relationships are omitted when the evidence does not establish them.
Main entry points: ingestion_service.py Ingestion service · optimization_pipeline_builder.py Pipeline builder · pipeline.py Pipeline runtime · useDatabaseConnections.js Connection hooks
Components 22
API and connections
- Application UI
frontend/src/App.jsx - Connection hooks
frontend/src/hooks/useDatabaseConnections.js - Connection service
frontend/src/services/databaseConnectionService.js - Connection API
backend/platform/databases/api/db_connection_router.py
SQL optimization
- Pipeline builder
backend/optimization/pipeline/optimization_pipeline_builder.py - Plan analysis
backend/optimization/analysis - Recommendations
backend/optimization/recommendation - Validation
backend/optimization/validation - Ranking
backend/optimization/ranking - Reporting
backend/optimization/reporting - Execution history
backend/optimization/history
Execution and ingestion
- Execution builder
backend/execution/pipeline/builder.py - Pipeline runtime
backend/execution/pipeline/pipeline.py - Ingestion service
backend/ingestion/services/ingestion_service.py - Execution collector
backend/ingestion/collectors/base_collector.py - Execution queue
backend/execution/queue/base_queue.py - Worker dispatcher
backend/execution/workers/dispatcher.py - Worker
backend/execution/workers/worker.py
Knowledge and assistant
- Context assembly
backend/knowledge/engine.py - Evidence retrieval
backend/knowledge/retrieval/engine.py - AI generation
backend/assistant/engine.py
Other components
- User
Connections 9
- User → Application UI: uses
- Connection hooks → Connection service: calls
frontend/src/hooks/useDatabaseConnections.js - Pipeline builder → Execution builder: builds with
backend/optimization/pipeline/optimization_pipeline_builder.py - Pipeline builder → Pipeline runtime: builds
backend/optimization/pipeline/optimization_pipeline_builder.py - Ingestion service → Execution collector: collects from
backend/ingestion/services/ingestion_service.py - Ingestion service → Execution queue: enqueues
backend/ingestion/services/ingestion_service.py - Ingestion service → Worker dispatcher: requests worker
backend/ingestion/services/ingestion_service.py - Ingestion service → Pipeline runtime: processes with
backend/ingestion/services/ingestion_service.py - Ingestion service → Worker: processes via
backend/ingestion/services/ingestion_service.py