MetaWiki Framework

Ein universelles, modulares Wissensgeruest fuer KI-gestuetzte Wissensarbeit

Vision

Ein einziges, vollstaendiges Wissensskelett – wiederverwendbar fuer jedes Projekt.

Das MetaWiki ist ein universelles, modular aufgebautes Wissensgeruest aus ca. 630+ kompakten Wissens-Stubs in 12 Wissenschaftsbereichen. Jeder Stub beschreibt ein Thema in 1–3 Saetzen, neutral, praezise und projektagnostisch – auf Deutsch und Englisch.

Die Idee

Ein einziges, vollstaendiges Wissensskelett
Wiederverwendbar fuer jedes Projekt
Erweiterbar nur dort, wo es gebraucht wird
Automatisiert transformierbar

Einsatzgebiete

KI-gestuetzte Wissensarbeit
Dokumentation & Recherche
Ontologien & Lernsysteme
Softwareprojekte

Grundidee

Alle Stubs werden in einer einheitlichen JSON-Struktur gespeichert.

Warum JSON?

Eigenschaft	Vorteil
Maschinenlesbar	Einfache Verarbeitung
Versionierbar	Git-freundlich
Python-kompatibel	Automatisierung
Uebersetzbar	Mehrsprachigkeit
KI-freundlich	LLM-Integration

Moegliche Outputs

                    ┌─────────────────┐
                    │   JSON Master   │
                    │    (Source)     │
                    └────────┬────────┘
                             │
        ┌────────────────────┼────────────────────┐
        │                    │                    │
        ▼                    ▼                    ▼
┌───────────────┐   ┌───────────────┐   ┌───────────────┐
│   Markdown    │   │   Obsidian    │   │   Webseiten   │
│    Files      │   │    Vault      │   │   (HTML)      │
└───────────────┘   └───────────────┘   └───────────────┘
        │                    │                    │
        ▼                    ▼                    ▼
┌───────────────┐   ┌───────────────┐   ┌───────────────┐
│  API-Daten    │   │  Embeddings   │   │ Uebersetzung  │
│   (REST)      │   │   (Vektor)    │   │   (EN/...)    │
└───────────────┘   └───────────────┘   └───────────────┘

JSON-Struktur

Beispiel eines Stubs

{
  "MetaWiki": {
    "07_Informatik_KI": {
      "Software_Engineering": [
        {
          "title": "Domain-Driven Design",
          "definition_de": "Ein Ansatz zur Modellierung komplexer Software, der die Fachdomaene in den Mittelpunkt stellt.",
          "definition_en": "An approach to modeling complex software that places the business domain at the center of development.",
          "relevance": "Hilft, komplexe Systeme verstaendlich und wartbar zu gestalten.",
          "tags": ["Informatik", "Software Engineering"]
        }
      ]
    }
  }
}

Felderklaerung

Feld	Beschreibung
`title`	Name des Konzepts
`definition_de`	Deutsche Definition (1–3 Saetze)
`definition_en`	Englische Uebersetzung
`relevance`	Warum ist das wichtig?
`tags`	Kategorisierung fuer Suche/Filter

Automatisierung

Python-Pipeline

import json

# JSON laden
with open("metawiki.json", "r", encoding="utf-8") as f:
    data = json.load(f)

# Alle Stubs abrufen (bilingual)
for category, subcats in data["MetaWiki"].items():
    for subcat, stubs in subcats.items():
        for stub in stubs:
            print(stub["title"])
            print(stub["definition_de"])  # Deutsch
            print(stub["definition_en"])  # English

# Neue Stubs nach dem Hinzufuegen uebersetzen
# python metawiki_pipeline.py translate

KI-Uebersetzung (Phase 4)

Alle 630 Stubs sind bereits vollstaendig zweisprachig (DE + EN). Fuer neue Stubs, die spaeter hinzugefuegt werden:

# API-Key setzen und optionales Paket installieren
export ANTHROPIC_API_KEY="<your-anthropic-api-key>"
pip install anthropic

# Alle Stubs uebersetzen (fehlende definition_en)
python metawiki_pipeline.py translate

# Mit Limit (z.B. nur 50 Stubs)
python metawiki_pipeline.py translate --limit 50

# Verfuegbarkeit pruefen
python translate.py --check

Als Python-Modul:

from translate import translate_text

english = translate_text("Ein Grenzwert beschreibt den Wert, dem sich eine Funktion annaeht.")
print(english)
# → "A limit describes the value that a function approaches."

Ohne gesetzten ANTHROPIC_API_KEY oder ohne pip install anthropic wird die Uebersetzung lautlos uebersprungen.

Nutzung / Usage

# CLI-Hilfe
python metawiki_cli.py --help

# Statistiken anzeigen
python metawiki_cli.py stats

# Konsistenz pruefen
python metawiki_cli.py check

# JSON nach Markdown exportieren
python metawiki_pipeline.py export --output --english

Unter Windows steht zusaetzlich start.bat als einfacher Einstieg fuer die CLI bereit. Exportierte Dateien landen in output/; dieser Ordner bleibt lokal und wird nicht versioniert.

Datenschutz / Privacy

MetaWiki arbeitet standardmaessig lokal mit metawiki.json und den Markdown-Exporten in diesem Repository. Es gibt keine Telemetrie und keine automatische Netzwerkkommunikation.

Nur der optionale Befehl python metawiki_pipeline.py translate kann externe API-Aufrufe ausloesen, wenn ANTHROPIC_API_KEY gesetzt ist und das optionale Paket anthropic installiert wurde.

Roadmap

Phase 1 - Strukturaufbau `[ABGESCHLOSSEN]`

Definition der 12 Oberthemen
Definition von 80-120 Hauptbereichen
630+ Stubs erstellt und in JSON importiert
Konsistenzpruefung (check_duplicates.py)

Phase 2 - JSON-Masterdatei `[ABGESCHLOSSEN]`

Alle Stubs in metawiki.json zusammengefuehrt (md_to_json.py)
Bidirektionale Synchronisation JSON <-> Markdown (metawiki_pipeline.py)

Phase 3 - Automatisierung `[ABGESCHLOSSEN]`

Python-Pipeline fuer Markdown-Export (metawiki_pipeline.py)
Markdown-Generator
Ordnerstruktur-Generator
CLI-Tool fuer Stub-Management (metawiki_cli.py)

Phase 4 - Mehrsprachigkeit `[ABGESCHLOSSEN]`

Automatische Uebersetzung in Englisch via Claude API (translate.py)
Optionale Uebersetzungen in weitere Sprachen (EN/FR/ES/IT/PT)
translate-Befehl in metawiki_pipeline.py

Phase 5 - Erweiterungen `[GEPLANT]`

JSON-Schema-Validierung
Einheitliches Tag-System
Export nach Obsidian / GitHub Pages
Sprachspezifische Markdown-Exports (DE/EN getrennt)
Embeddings-Generierung fuer Vektor-Suche
Such-API (REST)
Web-Interface (FastAPI + HTML)
KI-gestuetzte Stub-Erweiterung

Ziel

   ╔══════════════════════════════════════════════════╗
   ║                                                  ║
   ║   Ein Wissenssystem, das du einmal erzeugst      ║
   ║   und fuer immer wiederverwenden kannst.          ║
   ║                                                  ║
   ╚══════════════════════════════════════════════════╝

Das MetaWiki ist...

Eigenschaft	Beschreibung
In JSON gespeichert	Maschinenlesbar & versionierbar
In Markdown exportierbar	Menschenlesbar & dokumentierbar
Zweisprachig (DE/EN)	Vollstaendig uebersetzt
In jede Sprache uebersetzbar	Global einsetzbar
Modular erweiterbar	Waechst mit deinen Anforderungen
KI-freundlich	Optimiert fuer LLM-Integration
Projektagnostisch	Fuer jeden Anwendungsfall

_{Built with brain and AI | Maintained at file-bricks/MetaWiki}

English

A universal, modular knowledge framework for AI-assisted knowledge work

Vision

A single, complete knowledge skeleton – reusable for any project.

MetaWiki is a universal, modular knowledge framework of 630+ compact knowledge stubs across 12 scientific domains. Each stub describes a topic in 1–3 sentences, neutral, precise and project-agnostic – in German and English.

The Idea

A single, complete knowledge skeleton
Reusable for any project
Extendable only where needed
Automatically transformable

Use Cases

AI-assisted knowledge work
Documentation & Research
Ontologies & Learning Systems
Software Projects

Concept

All stubs are stored in a unified JSON structure.

Why JSON?

Property	Benefit
Machine-readable	Easy processing
Version-controlled	Git-friendly
Python-compatible	Automation
Translatable	Multilingual
AI-friendly	LLM integration

Possible Outputs

                    ┌─────────────────┐
                    │   JSON Master   │
                    │    (Source)     │
                    └────────┬────────┘
                             │
        ┌────────────────────┼────────────────────┐
        │                    │                    │
        ▼                    ▼                    ▼
┌───────────────┐   ┌───────────────┐   ┌───────────────┐
│   Markdown    │   │   Obsidian    │   │   Websites    │
│    Files      │   │    Vault      │   │   (HTML)      │
└───────────────┘   └───────────────┘   └───────────────┘
        │                    │                    │
        ▼                    ▼                    ▼
┌───────────────┐   ┌───────────────┐   ┌───────────────┐
│  API Data     │   │  Embeddings   │   │ Translation   │
│   (REST)      │   │   (Vector)    │   │   (EN/...)    │
└───────────────┘   └───────────────┘   └───────────────┘

JSON Structure

Example Stub

{
  "MetaWiki": {
    "07_Informatik_KI": {
      "Software_Engineering": [
        {
          "title": "Domain-Driven Design",
          "definition_de": "Ein Ansatz zur Modellierung komplexer Software, der die Fachdomaene in den Mittelpunkt stellt.",
          "definition_en": "An approach to modeling complex software that places the business domain at the center of development.",
          "relevance": "Hilft, komplexe Systeme verstaendlich und wartbar zu gestalten.",
          "tags": ["Informatik", "Software Engineering"]
        }
      ]
    }
  }
}

Field Description

Field	Description
`title`	Concept name
`definition_de`	German definition (1–3 sentences)
`definition_en`	English translation
`relevance`	Why does it matter?
`tags`	Categorization for search/filter

Automation

Python Pipeline

import json

# Load JSON
with open("metawiki.json", "r", encoding="utf-8") as f:
    data = json.load(f)

# Retrieve all stubs (bilingual)
for category, subcats in data["MetaWiki"].items():
    for subcat, stubs in subcats.items():
        for stub in stubs:
            print(stub["title"])
            print(stub["definition_de"])  # German
            print(stub["definition_en"])  # English

# Translate new stubs after adding them
# python metawiki_pipeline.py translate

AI Translation (Phase 4)

All 630 stubs are already fully bilingual (DE + EN). For new stubs added later:

# Set API key and install optional package
export ANTHROPIC_API_KEY="<your-anthropic-api-key>"
pip install anthropic

# Translate all stubs (missing definition_en)
python metawiki_pipeline.py translate

# With limit (e.g., only 50 stubs)
python metawiki_pipeline.py translate --limit 50

# Check availability
python translate.py --check

As a Python module:

from translate import translate_text

english = translate_text("Ein Grenzwert beschreibt den Wert, dem sich eine Funktion annaeht.")
print(english)
# → "A limit describes the value that a function approaches."

Without a set ANTHROPIC_API_KEY or without pip install anthropic, translation is silently skipped.

Usage

# CLI help
python metawiki_cli.py --help

# Show statistics
python metawiki_cli.py stats

# Check consistency
python metawiki_cli.py check

# Export JSON to Markdown
python metawiki_pipeline.py export --output --english

On Windows, start.bat provides a simple CLI entry point. Exported files are written to output/; that folder stays local and is not versioned.

Privacy

MetaWiki works locally by default with metawiki.json and the Markdown exports in this repository. It has no telemetry and no automatic network communication.

Only the optional python metawiki_pipeline.py translate command can make external API calls when ANTHROPIC_API_KEY is set and the optional anthropic package is installed.

Roadmap

Phase 1 - Structure Setup `[COMPLETED]`

Definition of 12 top-level topics
Definition of 80-120 main areas
630+ stubs created and imported into JSON
Consistency check (check_duplicates.py)

Phase 2 - JSON Master File `[COMPLETED]`

All stubs merged into metawiki.json (md_to_json.py)
Bidirectional synchronization JSON <-> Markdown (metawiki_pipeline.py)

Phase 3 - Automation `[COMPLETED]`

Python pipeline for Markdown export (metawiki_pipeline.py)
Markdown generator
Folder structure generator
CLI tool for stub management (metawiki_cli.py)

Phase 4 - Multilingual Support `[COMPLETED]`

Automatic translation to English via Claude API (translate.py)
Optional translations into additional languages (EN/FR/ES/IT/PT)
translate command in metawiki_pipeline.py

Phase 5 - Extensions `[PLANNED]`

JSON schema validation
Unified tag system
Export to Obsidian / GitHub Pages
Language-specific Markdown exports (DE/EN separate)
Embeddings generation for vector search
Search API (REST)
Web interface (FastAPI + HTML)
AI-assisted stub expansion

Goal

   ╔══════════════════════════════════════════════════╗
   ║                                                  ║
   ║   A knowledge system you build once              ║
   ║   and reuse forever.                             ║
   ║                                                  ║
   ╚══════════════════════════════════════════════════╝

MetaWiki is...

Property	Description
Stored in JSON	Machine-readable & version-controlled
Exportable to Markdown	Human-readable & documentable
Bilingual (DE/EN)	Fully translated
Translatable to any language	Globally deployable
Modularly extensible	Grows with your requirements
AI-friendly	Optimized for LLM integration
Project-agnostic	For any use case

_{Built with brain and AI | Maintained at file-bricks/MetaWiki}

Haftung / Liability

Dieses Projekt ist eine unentgeltliche Open-Source-Schenkung im Sinne der §§ 516 ff. BGB. Die Haftung des Urhebers ist gemäß § 521 BGB auf Vorsatz und grobe Fahrlässigkeit beschränkt. Ergänzend gelten die Haftungsausschlüsse der MIT-Lizenz.

Nutzung auf eigenes Risiko. Keine Wartungszusage, keine Verfügbarkeitsgarantie, keine Gewähr für Fehlerfreiheit oder Eignung für einen bestimmten Zweck.

This project is an unpaid open-source donation. Liability is limited to intent and gross negligence (§ 521 German Civil Code), with the MIT License disclaimers applying as well. Use at your own risk. No warranty, no maintenance guarantee, no fitness-for-purpose assumed.

Name		Name	Last commit message	Last commit date
Latest commit History 19 Commits
.github		.github
01_Mathematik		01_Mathematik
02_Physik_Astronomie		02_Physik_Astronomie
03_Chemie		03_Chemie
04_Biologie_Lebenswissenschaften		04_Biologie_Lebenswissenschaften
05_Medizin_Gesundheit		05_Medizin_Gesundheit
06_Psychologie_Kognition		06_Psychologie_Kognition
07_Informatik_KI		07_Informatik_KI
08_Technik_Ingenieurwesen		08_Technik_Ingenieurwesen
09_Gesellschaft_Politik		09_Gesellschaft_Politik
10_Wirtschaft_Recht		10_Wirtschaft_Recht
11_Geschichte_Archaeologie		11_Geschichte_Archaeologie
12_Kultur_Kunst_Sprache		12_Kultur_Kunst_Sprache
assets		assets
locales		locales
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
MetaWiki.ico		MetaWiki.ico
README.md		README.md
SECURITY.md		SECURITY.md
check_duplicates.py		check_duplicates.py
manage_translations.py		manage_translations.py
md_to_json.py		md_to_json.py
metawiki.json		metawiki.json
metawiki_cli.py		metawiki_cli.py
metawiki_pipeline.py		metawiki_pipeline.py
pipeline.py		pipeline.py
requirements.txt		requirements.txt
start.bat		start.bat
translate.py		translate.py
translator.py		translator.py

Folders and files

Latest commit

History

Repository files navigation

MetaWiki Framework

Ein universelles, modulares Wissensgeruest fuer KI-gestuetzte Wissensarbeit

Vision

Die Idee

Einsatzgebiete

Grundidee

Warum JSON?

Moegliche Outputs

JSON-Struktur

Beispiel eines Stubs

Felderklaerung

Automatisierung

Python-Pipeline

KI-Uebersetzung (Phase 4)

Nutzung / Usage

Datenschutz / Privacy

Roadmap

Phase 1 - Strukturaufbau [ABGESCHLOSSEN]

Phase 2 - JSON-Masterdatei [ABGESCHLOSSEN]

Phase 3 - Automatisierung [ABGESCHLOSSEN]

Phase 4 - Mehrsprachigkeit [ABGESCHLOSSEN]

Phase 5 - Erweiterungen [GEPLANT]

Ziel

Das MetaWiki ist...

English

Vision

The Idea

Use Cases

Concept

Why JSON?

Possible Outputs

JSON Structure

Example Stub

Field Description

Automation

Python Pipeline

AI Translation (Phase 4)

Usage

Privacy

Roadmap

Phase 1 - Structure Setup [COMPLETED]

Phase 2 - JSON Master File [COMPLETED]

Phase 3 - Automation [COMPLETED]

Phase 4 - Multilingual Support [COMPLETED]

Phase 5 - Extensions [PLANNED]

Goal

MetaWiki is...

Haftung / Liability

About

Topics

Resources

License

Code of conduct

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Phase 1 - Strukturaufbau `[ABGESCHLOSSEN]`

Phase 2 - JSON-Masterdatei `[ABGESCHLOSSEN]`

Phase 3 - Automatisierung `[ABGESCHLOSSEN]`

Phase 4 - Mehrsprachigkeit `[ABGESCHLOSSEN]`

Phase 5 - Erweiterungen `[GEPLANT]`

Phase 1 - Structure Setup `[COMPLETED]`

Phase 2 - JSON Master File `[COMPLETED]`

Phase 3 - Automation `[COMPLETED]`

Phase 4 - Multilingual Support `[COMPLETED]`

Phase 5 - Extensions `[PLANNED]`

Packages