Skip to content

pabloagn/phantom

Repository files navigation

Phantom

An open-source initiative to build a deeply interconnected, queryable digital canon of human art and thought.


─────── § ───────

Vision & Motivation: Curating a Digital Canon

In an age awash with ephemeral content and algorithmic noise, Phantom seeks to carve out a space for enduring works of human creativity and intellect. We face a deluge of information, the fragmentation of cultural memory, and the rise of "AI slop"—content endlessly remixed without grounding in original substance. It's increasingly difficult to connect with the foundational art, literature, and ideas that shape our understanding of ourselves and the world.

Phantom is our response: an ambitious project to build an open-source, canonical library. We are not aiming to catalog everything, but rather to meticulously curate a collection of significant works – the touchstones of art, literature, philosophy, and science – and transform them into a unified, deeply interconnected knowledge graph.

Our core motivations are:

  • Combat Information Overload: Provide a focused, high-signal resource amidst the noise, prioritizing depth and significance over sheer volume.
  • Preserve & Rediscover: Create a persistent, accessible digital home for canonical works, safeguarding them against cultural amnesia and making them newly discoverable.
  • Enable Deep Exploration: Move beyond keyword search. Allow users to explore the semantic relationships, thematic resonances, and intricate connections between works across different domains and eras.
  • Foster Meaningful Analysis: Build a structured, vectorized representation of the canon, enabling novel forms of computational analysis, visualization, and understanding.
  • Offer an Open Resource: Provide this curated and structured knowledge base as an open-source platform for researchers, students, artists, and the intellectually curious public.

Phantom aims to be more than a digital archive; it aspires to be a dynamic engine for exploring the heights of human expression and thought.


─────── § ───────

Overview

This repository serves as the central coordination point for the entire Phantom system, providing:

  • Design system and component library
  • Documentation for all system components
  • Configuration and standards
  • Development environment setup

Components

Phantom is structured as a monorepo using pnpm workspaces and Turborepo for build orchestration. All components are located under the packages/ directory.

The Phantom ecosystem consists of the following components:

Getting Started

This project uses pnpm for package management and Turborepo for task running.

Workflow 1: Initial Setup / After Major Dependency Changes

Clean

From monorepo root:

# Clean all packages from root directly
pnpm run clean

Install

From monorepo root:

# Install dependencies
pnpm install

Run

From monorepo root:

pnpm run build

Workflow 2: Development - Working on @phantom/docs (with Hot Reload for Docs & Core)

Run

From monorepo root, and in one terminal:

pnpm run dev:docs

Workflow 3: Development - Working on phantomklange (with Hot Reload for Klange & Core)

From monorepo root, and in one terminal:

pnpm run dev:klange

This ensures @phantom/core is built first, then @phantom/docs and phantomklange are built using the latest artifacts from @phantom/core.

Workflow 4: Building for Production/Preview

From monorepo root:

# Build all packages
pnpm run build

License

MIT