gravity-telescope
kentamatsuoka/gravity-telescope
Track developer migrations. Discover tomorrow's infrastructure before it becomes obvious.
Instalação
npx convez-ai kentamatsuoka/gravity-telescope1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
🔭 Gravity Telescope
Don't chase people — chase the movement. Don't chase orgs — chase the gravity. 人を追うな、移動を追え。組織を追うな、重力を追え。 不要追逐人,追逐迁移;不要追逐组织,追逐引力。
Observe developer migration on GitHub to find where valuable technology and infrastructure is being born — before it trends on social media or news.
Zero dependencies (standard library only). Python 3.12.
English
What it does
Skilled developers move before the narrative does. Gravity Telescope watches the movement of talent on GitHub and flags gravity anomalies — moments when several independent, high-signal developers quietly converge on the same small/new repository. The goal is not investment advice; it is discovering where value is being created.
Core idea
- Mass — skilled developers (contributors to themed repos)
- Movement — where each developer recently pushed / opened PRs / created repos (
events/public) - Gravity anomaly ⚡ — several independent skilled devs converging on the same small / new repo in a short window
- Migration event — a
(repo, dev)pair observed for the first time across runs = the trace of movement
It is not a snapshot. It accumulates time deltas in SQLite, so accuracy grows the more often you run it.
Quick start
cp .env.example .env # then put your GITHUB_TOKEN in .env
python3 run.py --rate # check remaining GitHub rate limit
python3 run.py --dry # small test run (light on API)
python3 run.py # full cycle: collect → detect migration → report → (Telegram)
python3 run.py --no-notify
GUI (browser dashboard)
python3 dashboard.py # open http://localhost:8770
python3 dashboard.py --port 9000
python3 dashboard.py --host 0.0.0.0 # if localhost is unreachable
- 🛰 Observe now button runs a cycle live (with Telegram on/off toggle), streaming progress
- 🚀 New migration events (cards, ⚡anomaly / 🌱new-repo badges)
- 🌌 Gravity ranking (bars, score-history sparklines, ▲▼ vs previous)
- Auto-refreshes every 20s while idle. Zero dependencies (stdlib
http.server).
Auth (no secrets in code)
Loaded at runtime from a local .env:
GITHUB_TOKEN— required (read-only public scope is enough)GRAVITY_TELEGRAM_TOKEN/GRAVITY_TELEGRAM_CHAT_ID— optional, for the Telegram digestGRAVITY_ENV_FILE— optional, point to other.envfile(s) to reuse existing secrets
Output
reports/latest.md— gravity ranking + migration events + an AI-analysis prompt per repogravity.db— developers / events / repo_devs / repo_score / runs (the time axis of migration)- Telegram — migration summary + TOP 5
File structure
| File | Role |
|---|---|
config.py | env loader + all knobs |
github_api.py | GitHub REST (rate-limit handling / stdlib) |
collect.py | themed repos → skilled devs → events → repo×dev observations |
db.py | SQLite (accumulates the time axis of migration) |
migration.py | gravity scoring + migration / anomaly detection |
report.py | Markdown report + AI-analysis prompt |
notify.py | Telegram notification |
run.py | orchestrator (CLI) |
dashboard.py + web/ | zero-dependency browser GUI |
Status / roadmap
- ✅ Migration detection (convergence, repo birth, run-to-run deltas)
- ✅ SQLite persistence (the time axis is the core)
- ✅ Transparent gravity score with breakdown
- ✅ Telegram notification
- ✅ Markdown report + AI-analysis prompt generation
- ✅ Zero-dependency browser dashboard
- ⬜ Live LLM call for the AI summary (prompt is generated; connection is next)
- ⬜ Contributor-cluster analysis / GraphQL / GH Archive / Farcaster / NPM·PyPI·Docker
日本語
これは何か
優秀な開発者は、物語が広まる前に動く。Gravity Telescope は GitHub 上の 才能の移動を観測し、重力異常——複数の独立した有望開発者が、同じ小さな/新しい リポジトリに静かに収束する瞬間——を検出する。投資助言ではなく、価値が生まれる場所の発見が目的。
核となる考え方
- 質量 … 優秀な開発者(テーマ repo の contributor)
- 移動 … その開発者が最近どこへ push / PR / repo 作成したか(
events/public) - 重力異常 ⚡ … 複数の独立した優秀 dev が、同じ小さな/新しい repo に短期間で収束
- 移住イベント … run をまたいで初観測した
(repo, dev)の組 = 移動の軌跡
スナップショットではなく、SQLite に貯めた時間差分で移住を捉える。回すほど精度が上がる。
使い方
cp .env.example .env # .env に GITHUB_TOKEN を記入
python3 run.py --rate # GitHub レート残量を確認
python3 run.py --dry # 小規模テスト(API 少なめ)
python3 run.py # 本番1サイクル(収集→移住検知→レポート→Telegram)
python3 run.py --no-notify
GUI(ブラウザ)
python3 dashboard.py # http://localhost:8770
python3 dashboard.py --host 0.0.0.0 # localhost で繋がらない時
🛰今すぐ観測 / 🚀移住カード / 🌌重力ランキング(スパークライン・前回比 ▲▼)。20秒毎自動更新・依存ゼロ。
認証(コードに秘密を持たない)
実行時に .env から読込:
GITHUB_TOKEN… 必須(公開リポジトリ読み取り権限で十分)GRAVITY_TELEGRAM_TOKEN/GRAVITY_TELEGRAM_CHAT_ID… 任意(Telegram 通知)GRAVITY_ENV_FILE… 任意(既存の.envを流用したい時にパス指定)
出力
reports/latest.md… 重力ランキング+移住イベント+repo 毎の AI 分析プロンプトgravity.db… developers / events / repo_devs / repo_score / runs(移住の時間軸)- Telegram … 移住サマリ+TOP5
実装状況
✅ 移住検知 / SQLite 永続化 / 重力スコア透明化 / Telegram / Markdown レポート / 依存ゼロ GUI ⬜ AI 要約の LLM 接続 / Contributor クラスタ / GraphQL / Farcaster / NPM・PyPI・Docker
中文
这是什么
优秀的开发者总在叙事流行之前就先行动。Gravity Telescope 观测 GitHub 上的 人才迁移,并标记引力异常——多个相互独立的高信号开发者,在短时间内悄悄 汇聚到同一个小型/新建仓库的时刻。目标不是投资建议,而是发现价值正在诞生的地方。
核心思想
- 质量 … 优秀开发者(主题仓库的贡献者)
- 迁移 … 该开发者最近在哪里 push / 提 PR / 新建仓库(
events/public) - 引力异常 ⚡ … 多个独立的优秀开发者在短窗口内汇聚到同一个小型/新建仓库
- 迁移事件 … 跨多次运行首次观测到的
(仓库, 开发者)组合 = 移动的轨迹
它不是快照,而是把时间差分累积进 SQLite,运行越频繁越准确。
快速开始
cp .env.example .env # 在 .env 中填入 GITHUB_TOKEN
python3 run.py --rate # 查看 GitHub 速率余额
python3 run.py --dry # 小规模测试(节省 API)
python3 run.py # 完整流程:采集→检测迁移→报告→Telegram
python3 run.py --no-notify
GUI(浏览器面板)
python3 dashboard.py # http://localhost:8770
python3 dashboard.py --host 0.0.0.0 # localhost 无法连接时
🛰立即观测 / 🚀迁移卡片 / 🌌引力排行(迷你折线图、与上次对比 ▲▼)。空闲时每20秒自动刷新,零依赖。
认证(代码中不含密钥)
运行时从本地 .env 读取:
GITHUB_TOKEN… 必填(只读公开仓库权限即可)GRAVITY_TELEGRAM_TOKEN/GRAVITY_TELEGRAM_CHAT_ID… 可选(Telegram 推送)GRAVITY_ENV_FILE… 可选(指向已有.env以复用密钥)
输出
reports/latest.md… 引力排行+迁移事件+每个仓库的 AI 分析提示词gravity.db… developers / events / repo_devs / repo_score / runs(迁移的时间轴)- Telegram … 迁移摘要+TOP5
状态 / 路线图
✅ 迁移检测 / SQLite 持久化 / 透明引力评分 / Telegram / Markdown 报告 / 零依赖 GUI ⬜ AI 摘要的 LLM 接入 / 贡献者聚类 / GraphQL / Farcaster / NPM·PyPI·Docker
Made for finding where the future is being built. / 未来が作られる場所を見つけるために。/ 为发现未来正在被构建的地方而生。