docs/GLOBAL_DEV_SETUP.md

Globale Entwickler-Umgebung (Windows / Cursor / GitHub / HF / APIs)

🔐 Echte Werte nur lokal: .env (Repo-Root, gitignored), optional master.env.ini (Repo oder ../EIRA/), MASTER_ENV_INI für einen absoluten Pfad. Nicht in Git, nicht in Chat-Kopien.

---

1. Multi-Agent-Überblick (dieses Workspace)

Bereich	Skript / Modul	Kurzbeschreibung
Agent 1–4	MULTI_AGENT_ASSET_ANALYSIS.py	Asset-Katalog, Impact, Integrität, Empfehlungen; nutzt workspace_env + Credential-Zeile
Agent 5–8	workspace_cleanup_agents.py (via --workspace-cleanup)	Cache-Hygiene, Git-Inventar, .gitignore-Block
Hyper-Agent	hyper_agent_system.py	Tool-Synthese / Loop; lädt jetzt .env über workspace_env
Seed-Sync	sync_orion_seed_complete.py	ORION_SEED_SOURCE / E:\ORION_SEED_COMPLETE → external/
Credential-Status	scripts/env_credential_status.py	Welche Env-Keys gesetzt sind (ohne Werte)
Netzwerk-Health	DDGK_DEV_NEXT_STEP.py	HF/GitHub/SerpAPI/News/Zenodo/Ollama; INI-Pfad portabel
HF-Check	hf_healthcheck.py	whoami; Quelle: .env → master.env.ini

---

2. Einmalig pro Maschine (oder pro User)

1. Python 3.10+ installieren; im Repo:
   pip install -r requirements.txt
   (optional: venv unter .venv anlegen und in Cursor als Interpreter wählen).

2. .env anlegen: Kopie von .env.example → .env, alle benötigten Keys ausfüllen (GitHub, HF, Zenodo, …).

3. master.env.ini: Falls du weiterhin die große INI nutzt: entweder im Repo-Root, oder unter …/EIRA/master.env.ini, oder MASTER_ENV_INI=C:\pfad\master.env.ini setzen.
   Hinweis: workspace_env spiegelt aus der INI nur die Allowlist-Keys (Pfade/Hosts: ORION_SEED_SOURCE, OLLAMA_*) nach os.environ. Tokens kommen zuverlässig über .env oder manuelles Exportieren / Terminal-envFile.

4. Cursor / VS Code (Workspace):

   • .vscode/settings.json: terminal.integrated.envFile und python.envFile zeigen auf ${workspaceFolder}/.env (Debugger + Tests sehen dieselben Variablen wie das Terminal).
   • Empfohlene Extensions: .vscode/extensions.json (Python, Pylance, GitLens).

5. Cursor User Settings (global): Snippet in docs/cursor-user-settings.snippet.json — z. B. terminal.integrated.envFile nur sinnvoll, wenn du immer in diesem Repo arbeitest; sonst Workspace-Settings bevorzugen.

6. PowerShell ohne Cursor: Session mit Repo-.env füllen:
   . .\scripts\load-workspace-env.ps1
   (Dot-Source im Repo ausführen.)

7. GitHub: gh auth login und/oder SSH-Remote; für Skripte GITHUB_TOKEN / GH_TOKEN / GITHUB_PAT in .env.

8. Hugging Face: In .env mindestens HUGGINGFACE_TOKEN oder HF_TOKEN setzen (viele Tools akzeptieren beides; hf_healthcheck bevorzugt HUGGINGFACE_TOKEN, fällt sonst auf HF_TOKEN zurück). Optional: huggingface-cli login → ~/.cache/huggingface/token.

9. MCP-Server in Cursor: In den MCP-Einstellungen nur Variablennamen referenzieren; Werte aus OS-Umgebung oder daraus, dass Cursor den Server mit geladener .env startet (je nach Version ggf. zusätzlich Windows-Benutzer-Umgebungsvariablen setzen).

10. Node/npm: Im Root gibt es kein zentrales package.json; Unterprojekte (z. B. repos/or1on-framework) jeweils mit npm install im jeweiligen Ordner — kein globales npm install -g nötig, außer ein Tool explizit -g verlangt.

---

3. AOIs / Endpoints (nur URLs, keine Keys)

• https://huggingface.co · https://huggingface.co/api/whoami
• https://api.github.com
• https://zenodo.org/api
• https://serpapi.com
• https://newsapi.org
• Ollama: http://127.0.0.1:11434 bzw. OLLAMA_PI5 / OLLAMA_NOTE10

---

4. Nach Token-Leak

Token auf dem jeweiligen Dienst rotieren, .env aktualisieren, nie erneut in Markdown committen (GitHub Secret Scanning).

---

5. Verwandte Doku

• docs/CURSOR_GITHUB_HF_SETTINGS.md — Kurzüberblick Cursor/GitHub/HF
• workspace_credentials.py — kanonische Liste der Env-Key-Namen
• AGENTS.md — Agenten-Verhalten im Repo