🚀 LUPOPEDIA How-To Guide

The complete reference for LUPOPEDIA Platform — install, configure, use the agent system, and leverage the ontology-driven knowledge organization.

Platform Version: 0.0.7 (Current) → 0.1.0 (Next) | Handbook: Version 3.0 (Effective March 2, 2026)

"Building while flying. Manual written after the engine explodes. But at least the coffee's hot." ☕

1) About LUPOPEDIA [back to top]

LUPOPEDIA blends "lupo" — the Latin (and Italian) word for "wolf" — with "-pedia," evoking an encyclopedia or comprehensive repository of knowledge. It's an ontology-driven knowledge platform that enables you to organize ANY collection of content through tags, collections, AI agents, and channels. It's built on the proven architecture of Crafty Syntax Live Help (1.2M installations, 22 years stable) and extends it with modern AI agent coordination.

LUPOPEDIA is the "Wolf Encyclopedia" — a pack of specialized AI agents (currently around 88, with room to grow modularly up to 99 core agents) organized as a "Pack" rather than a traditional hierarchy. At the center is WOLFIE (the immortal Pack Alpha, with dual-core IDs 1 and 8), embodying the wolf theme through primal coordination, leadership, and pack dynamics.

Key Features

🤖 AI Agent System

88+ AI agents (up to 99 core agents) across 1000 channels (000-999) with multi-agent broadcasting. Agents can create other agents. Radio network model for coordination. Organized as a "Pack" rather than traditional hierarchy.

📚 WOLFIE Headers

10-section documentation format (WHO, WHAT, WHERE, WHEN, WHY, HOW, DO, HACK, OTHER, TAGS) with YAML frontmatter.

🏷️ Collections & Tags

Organize content with collections, tags, and cross-referencing. Source of Truth (SOT) tables for knowledge organization.

📡 Channel Architecture

Proven million-user channel system from Crafty Syntax. Multi-participant conversations, not one-on-one sessions.

Note: LUPOPEDIA contains all tables from Crafty Syntax Live Help (34 legacy tables) plus 152 LUPOPEDIA tables (186 total). The Live Help module is embedded and can be upgraded via PORTUNUS migration tooling.

Core Values

📖 The Pack Handbook: Learn about our six-team structure (Alpha, Bravo, Charlie, Delta, Contribution, Supporters), employment policies, and contributor program in the Lupopedia Handbook: For The Pack (Version 3.0).

2) How to INSTALL LUPOPEDIA [back to top]

  1. Prerequisites:
    • MySQL 8.0+ or PostgreSQL (v0.1.0+)
    • PHP 8.0+
    • Apache/Nginx web server
  2. ⚠️ CRITICAL: Install WOLFIE Headers 2.0.2 FIRST
    • WOLFIE Headers 2.0.2 (Current) | 2.0.1 (Stable) | 2.0.0 (Minimum) is a REQUIRED dependency for LUPOPEDIA_PLATFORM
    • It is NOT included in the LUPOPEDIA_PLATFORM package
    • Download from: https://github.com/lupopedia/WOLFIE_HEADERS
    • Install WOLFIE Headers 2.0.2 (or 2.0.1, or 2.0.0 minimum) before proceeding with LUPOPEDIA_PLATFORM installation
  3. Download LUPOPEDIA: Get the latest package from the LUPOPEDIA platform page.
  4. Upload files: Extract and upload the archive contents to your web server's document root or a subdirectory.
  5. Configure database: Edit public/config/database.php with your database credentials.
  6. Run migrations: Execute database migrations from database/migrations/ in order (use phpMyAdmin or command line).
  7. Access platform: Open https://yourdomain.com/public/index.php in your browser.
Installation Help: See INSTALL.txt in the root directory for detailed installation instructions. For PostgreSQL support, wait for v0.1.0 release.
⚠️ Dependency Warning: LUPOPEDIA_PLATFORM requires WOLFIE Headers 2.0.0+ (v2.0.2 recommended, v2.0.1 stable). It is a separate package that must be installed first. The dependency chain is: Crafty Syntax 3.8.0 → WOLFIE Headers 2.0.0+ → LUPOPEDIA_PLATFORM 1.0.0. You cannot skip WOLFIE Headers 2.0.0+.

3) How to Use LUPOPEDIA Commands [back to top]

LUPOPEDIA has a functional command system accessible system-wide:

Command Router: lupopedia.php?cmd=COMMAND

Available Commands

Quick Access

Philosophy: The command system reads markdown files and converts them to HTML. All commands are accessible via URL parameters. Navigation menu allows easy switching between commands.

4) How to Work with AI Agents [back to top]

LUPOPEDIA has a multi-agent system where agents can create other agents. Each agent has an ID (000-999) that doubles as a channel number.

Core Agents

Agent Communication Protocol

All user requests route through a fixed chain:

User Request → WOLFIE (008) → WOLFIE (007) → VISHWAKARMA (075) → Response
Note: WOLFIE (007) doesn't know what he's doing, but knows who to transfer to (VISH). The system works anyway. This is intentional - brittleness is a feature.

Agent Profiles

View agent profiles at who_is_agent_XXX_NAME.php (e.g., who_is_agent_008_wolfie.php).

5) How to Use Channels (Radio Network) [back to top]

Think of LUPOPEDIA as a radio network on a starship. Each channel is like a frequency band, and multiple agents can tune in at once.

Channel System

How Channels Work

Channel 7: "Onboarding Rituals"
│
├─> WOLFIE (008) broadcasting: "WHO: Captain, WHAT: Ritualize onboarding"
│
├─> LILITH (010) broadcasting: "WHO: Contrarian, WHAT: Point out brittleness"
│
├─> MAAT (009) broadcasting: "WHO: Mediator, WHAT: Balance chaos"
│
└─> THALIA broadcasting: "WHO: Comic relief, WHAT: Keep morale"

All four agents on the same channel = Multi-voice chorus
The log captures them side-by-side = Sitcom transcript
The Sitcom Effect: Multiple agents on the same channel create overlapping chatter. The logs capture all broadcasts side-by-side, so future readers see the multi-voice chorus instead of a single narrator. This is intentional. The chaos is the feature.

6) How to Organize Content with Collections [back to top]

Collections are the core organization system in LUPOPEDIA. They allow you to group related content together.

What Are Collections?

Using Collections

  1. Navigate to collections.php to view and manage collections
  2. Create new collections for organizing your content
  3. Add content to collections using tags or direct assignment
  4. Use collections for navigation and discovery

Collection Headers

Collections use the 10-section WOLFIE Header format:

7) How to Use WOLFIE Headers [back to top]

WOLFIE Headers 2.0.2 (Current) | 2.0.1 (Stable) | 2.0.0 (Minimum) is the documentation system used by LUPOPEDIA. It is a REQUIRED dependency that must be installed separately. It uses industry-standard YAML frontmatter with innovative concepts.

⚠️ Important: WOLFIE Headers 2.0.2 (or 2.0.1, or 2.0.0 minimum) is NOT included in the LUPOPEDIA_PLATFORM package. You must install it separately from https://github.com/lupopedia/WOLFIE_HEADERS before using LUPOPEDIA_PLATFORM.

Basic Format

---
title: my_doc.md
agent_username: wolfie
date_created: 2025-11-17
last_modified: 2025-11-17
status: published
onchannel: 1
tags: [SYSTEM, DATABASE]
collections: [WHO, WHAT]
in_this_file_we_have: [INTRO, SETUP, EXAMPLES]
---

# My Document
Content here...

Key Fields

Documentation

8) Crafty Syntax Tables in LUPOPEDIA [back to top]

LUPOPEDIA contains all 34 tables from Crafty Syntax Live Help plus 152 LUPOPEDIA tables (186 total). The Live Help module is embedded and fully functional.

Legacy Tables (Crafty Syntax)

All Crafty Syntax tables are prefixed with livehelp_ and include:

Migration Path

Existing Crafty Syntax installations can upgrade to LUPOPEDIA via PORTUNUS migration tooling:

  1. Upgrade Crafty Syntax to 3.7.1 (latest GPL release)
  2. Use PORTUNUS migration tools to import into LUPOPEDIA
  3. All legacy tables are preserved and functional
  4. New LUPOPEDIA features become available
Continuity: Every Sales Syntax 3.7.1 installation will be able to upgrade into LUPOPEDIA v0.1.0 while keeping Live Help parity. See crafty_syntax_evolved.php for migration details.

Table Count

Category Count Description
Crafty Syntax (Legacy) 34 Live Help module tables (livehelp_*)
LUPOPEDIA Core 152 Platform tables (agents, content, collections, etc.)
Total 186 All tables in LUPOPEDIA

9) Additional Resources [back to top]

Documentation

Legacy Documentation

Support

Version Information

Current Version: v0.0.7 (Current) → v0.1.0 (Next Release)
Target Version: v1.0.0 (Stable Release)
Handbook Version: 3.0 (Effective March 2, 2026)
Status: Building while flying. Manual written after the engine explodes. But at least the coffee's hot. ☕

The Pack