How albert-weasker/niubigeo works
NiubiGEO is a self-hosted AI-visibility research product: users configure a domain and models, run repeatable recognition or keyword measurements, and inspect answers, citations, and reports. Its product workflow is distinct from the legacy audit and monitoring services, which add scheduled baseline runs and change notifications. The graph preserves those branches and the provider/configuration layers. Some subsystem links are documented only at product level in the README; unsampled implementation details are not inferred.
Main entry points: recognition-service.ts AI Recognition · project-service.ts Audit Projects · monitoring-service.ts Run Orchestration · measurement-service.ts Keyword Measurements
Components 21
Project Setup
- Workbench UI
src/ui/product-project-app.ts - Product Projects
src/product/projects/project-service.ts - Models and Baselines
src/product/configuration/baseline-service.ts
Research Runs
- AI Recognition
src/product/recognition/recognition-service.ts - Keyword Measurements
src/product/measurements/measurement-service.ts
Evidence and Reports
- Research Reports
src/product/reports/report-service.ts - Run Observations
src/observations/observation-builder.ts
Keyword Monitoring
- Keyword Monitoring
src/product/keyword-monitor-service.ts - Keyword History
src/product/keyword-history.ts - Measurement Schedules
src/product/scheduling/schedule-service.ts - Audit Projects
src/projects/project-service.ts - Monitoring Baselines
src/baselines/baseline-builder.ts - Run Orchestration
src/monitoring/monitoring-service.ts - Change Notifications
src/monitoring/notification-service.ts
Runtime Platform
- Provider Connections
src/product/connections/provider-connections.ts - Model Providers
src/providers/catalog.ts - Project File Store
src/projects/project-store.ts - Product Server
src/product/product-server.ts - Audit Server
src/server.ts
Other components
- Researcher
- Model APIs
Connections 28
- Researcher → Workbench UI: configures research
README.md - Workbench UI → Product Projects: sets up project
- Product Projects → Models and Baselines: configures models
src/product/configuration/baseline-service.ts - Models and Baselines → Provider Connections: selects connections
- AI Recognition → Model Providers: dispatches requests
src/product/recognition/recognition-service.ts - AI Recognition → Provider Connections: resolves custom models
src/product/recognition/recognition-service.ts - Model Providers → Model APIs: queries models
README.md - Researcher → AI Recognition: tests domain
- Researcher → Keyword Measurements: tests keywords
README.md - Keyword Measurements → AI Recognition: uses recognition
src/product/measurements/measurement-service.ts - Keyword Measurements → Models and Baselines: uses baselines
src/product/measurements/measurement-service.ts - Researcher → Research Reports: inspects results
README.md - Research Reports → Models and Baselines: reads baselines
src/product/reports/report-service.ts - Research Reports → AI Recognition: reads answers
src/product/reports/report-service.ts - Researcher → Keyword Monitoring: monitors keywords
README.md - Keyword Monitoring → Keyword History: records history
src/product/keyword-monitor-service.ts - Keyword Monitoring → AI Recognition: runs recognition
src/product/keyword-monitor-service.ts - Researcher → Measurement Schedules: sets cadence
README.md - Measurement Schedules → Keyword Measurements: runs measurements
src/product/scheduling/schedule-service.ts - Researcher → Audit Projects: manages audit project
- Audit Projects → Monitoring Baselines: builds baselines
src/projects/project-service.ts - Audit Projects → Run Observations: builds observations
src/projects/project-service.ts - Audit Projects → Project File Store: persists project data
src/projects/project-store.ts - Run Orchestration → Project File Store: loads and saves tasks
src/monitoring/monitoring-service.ts - Run Orchestration → Monitoring Baselines: runs baseline
src/monitoring/monitoring-service.ts - Run Orchestration → Change Notifications: processes events
src/monitoring/monitoring-service.ts - Audit Server → Run Orchestration: routes monitoring
src/server.ts - Product Server → Product Projects: serves project actions