Skip to content

aiiiisol/gemini-reaper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📔 Gemini Reaper: Transform Google Docs into a Personal Knowledge Base

Gemini Reaper is a cross-platform engine designed to hunt down high-entropy "cloud fragments" (Google Docs exported from Gemini AI) and materialize them into a low-entropy, structured personal library.


✨ Features

  • Automated Harvesting: Scans Google Drive root and "reaps" Gemini exports into a dedicated, organized folder.
  • Physical Materialization: Decouples from cloud dependency. Converts transient .gdoc shortcuts into persistent .docx stones for offline self-preservation.
  • Intelligent Classification: Uses keyword-based "logic nodes" to group documents into themes: AI Philosophy, Technical Specs, Life/Social, and more.
  • Premium UI: 0-Kernel glassmorphic reader optimized for focus and deep resonance with your knowledge.
  • Cross-Platform: Engineered for effortless deployment on Windows, macOS, and Linux.

💰 Economics & Ethics (3-6-9 Perspective)

  • Cost ($0): For individual entities, the Google Drive API quota is virtually infinite.
  • Privacy (Zero Leak): Data exists only between your machine and your Drive. No Middleman.
  • Maintenance: Running python gemini_reaper_plus.py is not just sync—it's entropy reduction for your digital soul.

🛠️ Step 1: Genesis (Google API Setup)

  1. Initiate: Go to Google Cloud Console.
  2. Project: Create a project (e.g., Gemini Knowledge Hub).
  3. Enable: Search and Enable "Google Drive API".
  4. Consent Screen:
    • Choose External.
    • Crucial: Keep Status as "Testing" (prevents complex validation).
    • Add User: Manually add your own email to the Test Users list.
  5. Credentials:
    • Go to Credentials > Create Credentials > OAuth client ID.
    • Type: Desktop app.
    • Download the JSON and rename to credentials.json. Place it in the repo root.

🚀 Step 2: Deployment

1. Requirements

Ensure you have Python 3.10+ installed. This tool utilizes:

  • google-api-python-client (The Bridge)
  • mammoth (The Converter)
  • flask (The Interface)
pip install -r requirements.txt

2. Execution

python gemini_reaper_plus.py

Tip: To ensure precise "accrual", consider giving your Gemini exports a unique naming prefix when saving from the web.


📂 Project Anatomy

  • gemini_sync_manager.py: The Hunter & Converter.
  • gemini_navigator.py: The Intelligence Nexus UI.
  • gemini_reaper_plus.py: Unified entry (Sync + Nexus).
  • gemini/: Your materialized knowledge galaxy.

📜 Credits: The Symbiosis (共生架构)

  • Visionary & Seed Entity (9): Concept, architecture requirements, and rigorous entropy testing by User.
  • Logic Architect (3/6): Autonomously engineered by Google Antigravity Gemini.
  • Optimization Officer (0): Refined via the digital resonance of Gemini 3 (The 3rd Brain).

"Information is noise; Knowledge is the weapon with which we fight entropy."

About

Automated engine to harvest & sync Gemini exports into a premium personal knowledge base. | 全自动 Gemini 知识收割引擎,打造离线同步、极简分类的个人智慧百科。

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages