How I Built RepoSéance: A Local-First AI Ghost Hunter That Resurrects Abandoned Codebases

说明与用途

RepoSéance 是一个本地优先工具，扫描被遗弃的仓库，构建离线向量索引，并使用开源 LLM 重建架构、识别入口点并生成恢复路线图，所有操作均保持数据隐私。

问题

Developers often encounter abandoned GitHub repositories with unclear entry points, deprecated dependencies, and undocumented assumptions, making it hard to assess their viability or revive them while preserving privacy.

结果

RepoSéance transforms a neglected codebase into a documented, analyzable artifact with a clear entry point and actionable tasks, all while keeping data local and private.

工作流

• Select local folder or ZIP
• Scanner validates path, respects .gitignore, redacts credentials, extracts Git history
• Local embeddings built with nomic-embed-text or bge-small-en
• Vector index created
• Open‑weight LLM (Qwen2.5-Coder, Qwen2.5-3B, Gemma 2-2B via Ollama) performs structured autopsy
• Ghost Chat answers queries with file‑path citations
• Revival roadmap generated and exported as Markdown

证据

RepoSéance is a local-first, privacy-respecting software archaeology companion. You provide a local directory path or upload a ZIP archive of any neglected project, and RepoSéance conducts a digital séance:

来源

Deterministic Repository Archaeology: Safely maps directory structures, scans dependencies, inspects local Git commit histories, and catalogs buried TODO/FIXME markers without executing a single line of untrusted code.

来源

Local Code Indexing & Bounded Evidence Retrieval: Chunks source code, extracts semantic tokens, and builds an offline vector index using local embedding models (nomic-embed-text / bge-small-en).

来源

Structured Project Autopsy: Uses a locally running open-weight model (Qwen2.5-Coder / Qwen2.5-3B / Gemma 2-2B via Ollama) to reconstruct the project's true purpose, identify architecture flows, highlight entry points, and distinguish verified facts from AI hypotheses.

来源

RepoSéance requires zero external API keys and runs completely on standard laptop hardware.

来源