Converti (AetherOS)

From OODA WIKI
Revision as of 03:09, 9 August 2025 by AdminIsidore (talk | contribs) (Created page with "{{AetherOS_Component}} '''Converti''' is a command-line utility designed to import articles from external wikis, such as Wikipedia, and intelligently prepare them for use within the AetherOS ecosystem. It serves as a gatekeeper, ensuring that new information is clean, functional, and structurally sound before it becomes a source of knowledge for both human users and their Wingman AIs. The tool was developed by Isidore Lands and Silas...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
This page describes a core component of the AetherOS ecosystem. Its structure and content are designed to be parsed by automated agents.

Converti is a command-line utility designed to import articles from external wikis, such as Wikipedia, and intelligently prepare them for use within the AetherOS ecosystem. It serves as a gatekeeper, ensuring that new information is clean, functional, and structurally sound before it becomes a source of knowledge for both human users and their Wingman AIs.

The tool was developed by Isidore Lands and Silas Corvus.

Purpose in Symbiotic Learning

The core purpose of Converti is to support the symbiotic learning relationship between a user and their Wingman AI. Raw, unformatted text from external sources can contain broken templates, irrelevant maintenance tags, and visual media that can confuse a learning model.

Converti sanitizes this content, creating a clean textual baseline that is optimized for machine readability and comprehension. By ensuring the structural integrity of imported knowledge, it prevents the Wingman from learning from "broken" or incomplete data.

Core Functionality

Converti is a Python script that uses the Pywikibot framework to perform a multi-stage import and cleaning process.

Stage 1: Content Cleaning

When an article is imported, Converti first performs two cleaning passes on the wikitext:

  1. Image Removal: All file links (e.g., `File:...`) and gallery tags (`<gallery>`) are stripped from the text. This focuses the content on pure text, which is the primary medium for the Wingman AI.
  2. Template Reformatting: Common Wikipedia-specific maintenance templates (e.g., `Template:Cleanup`, `Template:Unreferenced`) are removed, as they are not relevant to the local wiki's context.

Stage 2: Recursive Dependency Resolution

After cleaning the text, Converti scans the article for all required Templates and Modules.

  1. It checks if each dependency exists on the local wiki.
  2. If a dependency is missing and its corresponding local page is empty, Converti automatically imports it from the source wiki (Wikipedia).
  3. This process is recursive; the script then checks the newly imported dependency for its own dependencies and adds them to an import queue. This continues until all required components are present.
  4. To ensure safety, Converti will not overwrite any template or module that already has content, preserving any local customizations.

Stage 3: Reporting

Upon completion, the script generates a detailed report listing all the dependencies it successfully imported and any it skipped because they already existed.

Usage

Converti is run from the command line. The user specifies the title of the page to import.

# Example: Import the "OODA loop" article from Wikipedia
python scripts/wiki_importer.py --page "OODA_loop"

Future Development

  • Active Voice Assistant: Functionality is being developed to create a human-in-the-loop tool that will identify passive voice sentences in an article and allow an editor to convert them to active voice, further improving clarity and readability.