convez.ai
MCP Server
kentamatsuoka

gravity-telescope

kentamatsuoka/gravity-telescope

Ver no GitHub
InicialPluginScore · de 0 a 100

Track developer migrations. Discover tomorrow's infrastructure before it becomes obvious.

Instalação

$npx convez-ai kentamatsuoka/gravity-telescope

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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.

Languages: English ・ 日本語 ・ 中文

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 digest
  • GRAVITY_ENV_FILE — optional, point to other .env file(s) to reuse existing secrets

Output

  • reports/latest.md — gravity ranking + migration events + an AI-analysis prompt per repo
  • gravity.db — developers / events / repo_devs / repo_score / runs (the time axis of migration)
  • Telegram — migration summary + TOP 5

File structure

FileRole
config.pyenv loader + all knobs
github_api.pyGitHub REST (rate-limit handling / stdlib)
collect.pythemed repos → skilled devs → events → repo×dev observations
db.pySQLite (accumulates the time axis of migration)
migration.pygravity scoring + migration / anomaly detection
report.pyMarkdown report + AI-analysis prompt
notify.pyTelegram notification
run.pyorchestrator (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. / 未来が作られる場所を見つけるために。/ 为发现未来正在被构建的地方而生。

Ver o original no GitHub

Bom para

Relacionados