How doni9480/serebra works
Serebra turns hiring, public GitHub, and first-party publication data into evidence-linked company intelligence and market analytics. The main path is collection or vacancy import, normalization and deduplication, factual events, period comparisons, signals, hypotheses, and weighted evidence; API and dashboards expose the results. Distinct source-specific ingestion and intelligence branches also support company comparison, market summaries and salary analysis, collector-run tracking, company consolidation, and exchange rates. The README documents several capabilities whose implementation was not sampled, so those links are documented rather than inferred from unseen code.
Main entry points: companies.py Company API · intelligence.py Hiring intelligence · market.py Market API · main.py FastAPI runtime
Components 30
API and dashboards
- FastAPI runtime
backend/main.py - Company API
backend/api/routes/companies.py - Market API
backend/api/routes/market.py - Comparison API
backend/api/routes/comparison.py - Hypothesis API
backend/api/routes/hypotheses.py - Company dashboard
backend/static/dashboard.js - Market dashboard
backend/static/market.js
Source collection
- DevKG collector
backend/collectors/devkg.py - Greenhouse collector
backend/collectors/greenhouse.py - GitHub collector
backend/collectors/github.py - RSS / Atom collector
backend/collectors/web_feed.py
Ingestion and records
- Vacancy ingestion
backend/services/ingestion.py - Market ingestion
backend/services/market_ingestion.py - GitHub ingestion
backend/services/github_ingestion.py - Publication ingestion
backend/services/web_ingestion.py - Vacancy normalization
backend/services/normalization.py - Company identity
backend/services/company_normalization.py - Company consolidation
backend/services/company_consolidation.py
Intelligence and analytics
- Hiring intelligence
backend/services/intelligence.py - GitHub intelligence
backend/services/github_intelligence.py - Publication intelligence
backend/services/web_intelligence.py - Company comparison
backend/services/company_comparison.py - Market analytics
backend/services/market_analytics.py - Collector run log
backend/services/collector_runs.py
Persistence
- Relational store
backend/db/models.py - Database sessions
backend/db/base.py
Other components
- API clients
- External feeds
- GitHub API
- Greenhouse API
Connections 43
- API clients → FastAPI runtime: requests
- FastAPI runtime → Company API: routes
backend/main.py - FastAPI runtime → Market API: routes
backend/main.py - FastAPI runtime → Comparison API: routes
backend/main.py - FastAPI runtime → Hypothesis API: routes
backend/main.py - Company API → Vacancy ingestion: imports
backend/api/routes/companies.py - Company API → Greenhouse collector: collects
backend/api/routes/companies.py - Company API → GitHub collector: collects
backend/api/routes/companies.py - Company API → RSS / Atom collector: collects
backend/api/routes/companies.py - Company API → Company consolidation: resolves identity
backend/api/routes/companies.py - External feeds → DevKG collector: provides posts
- External feeds → RSS / Atom collector: provides feeds
- GitHub API → GitHub collector: provides data
- Greenhouse API → Greenhouse collector: provides jobs
- Market API → DevKG collector: collects
backend/api/routes/market.py - Market API → Market ingestion: imports
backend/api/routes/market.py - Market ingestion → DevKG collector: uses snapshot
backend/services/market_ingestion.py - Market ingestion → Vacancy ingestion: imports vacancies
backend/services/market_ingestion.py - Market ingestion → Company identity: normalizes names
backend/services/market_ingestion.py - Market ingestion → Company consolidation: finds identity
backend/services/market_ingestion.py - Vacancy ingestion → Vacancy normalization: normalizes
backend/services/ingestion.py - Vacancy ingestion → Hiring intelligence: recalculates
backend/services/ingestion.py - Company API → Hiring intelligence: serves signals
backend/api/routes/companies.py - GitHub ingestion → GitHub collector: uses snapshots
backend/services/github_ingestion.py - GitHub ingestion → GitHub intelligence: recalculates
backend/services/github_ingestion.py - Publication ingestion → RSS / Atom collector: uses snapshots
backend/services/web_ingestion.py - Publication ingestion → Publication intelligence: recalculates
backend/services/web_ingestion.py - Hiring intelligence → Relational store: stores results
backend/services/intelligence.py - GitHub intelligence → Hiring intelligence: contributes signals
backend/services/github_intelligence.py - Publication intelligence → Hiring intelligence: contributes signals
backend/services/web_intelligence.py - Hiring intelligence → Relational store: stores evidence
backend/services/intelligence.py - Comparison API → Company comparison: calls
backend/api/routes/comparison.py - Company comparison → Hiring intelligence: uses intelligence
backend/services/company_comparison.py - Market API → Market analytics: queries
backend/api/routes/market.py - Hypothesis API → Relational store: reads hypotheses
backend/api/routes/hypotheses.py - Company dashboard → Company API: displays company data
- Market dashboard → Market API: displays market data
- Company API → Collector run log: records runs
backend/api/routes/companies.py - Market API → Collector run log: records runs
backend/api/routes/market.py - Collector run log → Relational store: persists runs
backend/services/collector_runs.py - Database sessions → Relational store: opens sessions
backend/db/base.py - Company consolidation → Hiring intelligence: reconciles records
backend/services/company_consolidation.py - Market API → Market analytics: summarizes salaries
backend/api/routes/market.py