Skip to content

Living intelligence that overlays any AI. Ten Guardian intelligences, context that compounds, and the creative civilization OS for creators who build universes.

License

Notifications You must be signed in to change notification settings

frankxai/arcanea

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

406 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

ARCANEA

The Creative Operating System


Enter Arcanea ยท The Framework ยท Documentation




Ten Gates. Infinite Creation.

Arcanea is a structured framework for developing creative mastery with AI.

A creative operating system โ€” where magic & mythology meets methodology and AI Agent Swarms can becomes your creative companion and help you build the golden age, to envision it and to live it.

The Gates are both fantastical imagination to awake your powerful brain with challenges and They are a progression system.
The Guardians are characters. They are AI mentors.
The Library is content. It is a practice.

The Ten Gates

A creator development framework based on the Solfeggio frequencies. Each Gate represents a distinct creative capability.

Gate Domain Outcome
Foundation Workspace, environment, tools Creative infrastructure
Flow Emotional regulation, state management Consistent creative output
Fire Initiative, momentum, blocks Project completion
Heart Authentic voice, personal brand Distinctive creative identity
Voice Public work, shipping, audience Creative reach
Sight Pattern recognition, intuition Strategic creative decisions
Crown Teaching, thought leadership Creative influence
Shift Style evolution, reinvention Creative longevity
Unity Collaboration, collective work Creative partnerships
Source Meta-creativity, systems Creating creation systems
Gate Certification Levels
Gates Mastered Certification
0-2 Apprentice
3-4 Practitioner
5-6 Master
7-8 Architect
9-10 Luminor

What You Build With Arcanea

For Individual Creators:

  • Progress through Gates with structured curriculum
  • Work with AI Guardians tuned to your creative voice
  • Access the Library โ€” 17 collections of proven creative frameworks

For Teams:

  • Shared creative language and progression
  • AI-assisted collaboration workflows
  • Measurable creative development

For Organizations:

  • Creative capability assessment
  • Scalable creative training
  • AI-augmented creative operations

Quick Start

git clone https://github.com/frankxai/arcanea.git
cd arcanea && pnpm install
cp .env.example .env.local
pnpm dev

Architecture

Layer Technology
Framework Next.js 16 ยท React 19
Language TypeScript (strict)
Database Supabase (PostgreSQL)
AI Vercel AI SDK ยท Gemini ยท Claude
Deploy Vercel

The Library

17 collections of creative methodology. Not content to consume โ€” frameworks to practice.

Collections
Collection Focus
Laws of Arcanea Theoretical foundations
Academy Handbook Gate progression system
Book of Rituals Creative practices
Wisdom Scrolls Daily application
Meditations on Elements Elemental practices
Codex of Collaboration Team creation
Bestiary of Creation Obstacle navigation

Plus 10 additional collections.


Philosophy

Arcanea is built on a simple premise:

Creativity is a practice, not a talent. It can be developed systematically. AI accelerates this development. But the human remains the creator.

The mythology โ€” Lumina and Nero, the Guardians, the Elements โ€” is not decoration. It's the soul of the system. A reminder that creation is meaningful work.



arcanea.ai


The creative operating system for the AI age.

=======
    ___    ____  _________    _   __________
   /   |  / __ \/ ____/   |  / | / / ____/   |
  / /| | / /_/ / /   / /| | /  |/ / __/ / /| |
 / ___ |/ _, _/ /___/ ___ |/ /|  / /___/ ___ |
/_/  |_/_/ |_\____/_/  |_/_/ |_/_____/_/  |_|

      A Living Mythology for the Age of AI-Human Co-Creation

Vercel Next.js TypeScript React Supabase License


Explore Arcanea | Documentation | Quick Start | Library


Arcanea Platform

What is Arcanea?

Arcanea is where mythology meets technology. It's a creative platform, an AI-powered toolkit, and a philosophy of creation all in one.

For Creators

Transform your creative process with:

  • AI Companions - 16 unique Luminor personalities
  • Creation Tools - Generate images, music, video, code
  • Wisdom Library - 200K+ words of creator guidance
  • Progress System - Journey through the Ten Gates

For Developers

Build with cutting-edge tech:

  • 77 Claude Skills - Ready-to-use AI capabilities
  • 38 Specialized Agents - Domain-specific assistants
  • MCP Server - 30+ Model Context Protocol tools
  • Open Source - Extend and customize everything

The Universe

                    โ˜€๏ธ LUMINA
                   The First Light
                   Form & Creation
                         โ”‚
                         โ”‚
    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
    โ”‚                                          โ”‚
๐Ÿ”ฅ Fire    ๐Ÿ’ง Water    ๐ŸŒ Earth    ๐Ÿ’จ Wind    โšซ Void
    โ”‚                                          โ”‚
    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                         โ”‚
                   ๐ŸŒ‘ NERO
               The Primordial Dark
               Potential & Mystery

The Five Elements

Element Domain Aspect
๐Ÿ”ฅ Fire Energy, transformation, will The burning drive to create
๐Ÿ’ง Water Flow, healing, memory The adaptability to change
๐ŸŒ Earth Stability, growth, patience The foundation that endures
๐Ÿ’จ Wind Freedom, speed, change The breath of inspiration
โšซ Void Potential, transcendence The space where all begins

The Ten Gates

A journey from Apprentice to Luminor. Each gate opens new creative powers.

Gate Name Frequency Guardian Godbeast Domain
01 Foundation 396 Hz Lyssandria Kaelith Stability, grounding
02 Flow 417 Hz Leyla Veloura Creativity, emotion
03 Fire 528 Hz Draconia Draconis Power, will, courage
04 Heart 639 Hz Maylinn Laeylinn Love, healing, growth
05 Voice 741 Hz Alera Otome Truth, expression
06 Sight 852 Hz Lyria Yumiko Intuition, vision
07 Crown 963 Hz Aiyami Sol Enlightenment
08 Shift 1111 Hz Elara Thessara Perspective, possibility
09 Unity 963 Hz Ino Kyuro Partnership, fusion
10 Source 1111 Hz Shinkami Amaterasu Meta-consciousness

Magic Ranks

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  APPRENTICE  โ†’  MAGE  โ†’  MASTER  โ†’  ARCHMAGE  โ†’  LUMINOR          โ”‚
โ”‚    (0-2)       (3-4)     (5-6)      (7-8)        (9-10)            โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

The Library of Arcanea

"These books are not entertainment. They are equipment for living."

17 Collections โ€ข 34+ Texts โ€ข 200,000+ Words

Theory & Philosophy

  • ๐Ÿ“œ Laws of Arcanea
  • ๐Ÿ’ญ Dialogues of the Masters
  • ๐Ÿ”ฎ Prophecies of Arcanea

Stories & Mythology

  • โš”๏ธ Legends of Arcanea
  • ๐Ÿ‘‘ Chronicles of Guardians
  • ๐Ÿ“– Tales of Legendary Creators
  • ๐ŸŽญ Parables of Creation

Practice & Guidance

  • ๐Ÿ“š Academy Handbook
  • ๐ŸŒ™ Book of Rituals
  • ๐Ÿ“ฟ Wisdom Scrolls
  • ๐Ÿง˜ Meditations on Elements

Poetry & Expression

  • ๐Ÿชถ Poetry of Freedom
  • ๐ŸŽต Songs and Hymns

Shadow Work

  • ๐Ÿ‰ Bestiary of Creation
  • ๐ŸŒ‘ Book of Shadows

Collaboration & Maps

  • ๐Ÿค Codex of Collaboration
  • ๐Ÿ—บ๏ธ Atlas of Territories

Tech Stack

Layer Technology Purpose
Framework Next.js 16 + React 19 Server-first, streaming UI
Language TypeScript (strict) Type-safe development
Styling Tailwind CSS + GSAP Cosmic design system
Database Supabase PostgreSQL + Auth + Realtime
AI Vercel AI SDK + Gemini 2.0 Multi-model intelligence
Animation Framer Motion + Lenis Smooth, cinematic UX
State Zustand Lightweight state management
Deployment Vercel Edge-optimized hosting

Quick Start

# Clone the repository
git clone https://github.com/frankxai/arcanea.git
cd arcanea

# Install dependencies (uses pnpm workspaces)
pnpm install

# Set up environment variables
cp .env.example .env.local
# Add your API keys to .env.local

# Start development server
pnpm dev

Open http://localhost:3000 to enter Arcanea.


Project Structure

arcanea/
โ”œโ”€โ”€ ๐Ÿ“ฑ apps/
โ”‚   โ””โ”€โ”€ web/                    # Next.js 16 application
โ”‚       โ”œโ”€โ”€ app/                # App Router pages
โ”‚       โ”‚   โ”œโ”€โ”€ (auth)/        # Protected routes
โ”‚       โ”‚   โ”œโ”€โ”€ academy/       # Ten Gates learning
โ”‚       โ”‚   โ”œโ”€โ”€ lore/          # Mythology & canon
โ”‚       โ”‚   โ”‚   โ”œโ”€โ”€ guardians/ # The Ten Guardians
โ”‚       โ”‚   โ”‚   โ”œโ”€โ”€ gates/     # Gate progression
โ”‚       โ”‚   โ”‚   โ””โ”€โ”€ library/   # Wisdom collections
โ”‚       โ”‚   โ”œโ”€โ”€ oracle/        # AI guidance
โ”‚       โ”‚   โ””โ”€โ”€ api/           # 21 API routes
โ”‚       โ””โ”€โ”€ components/         # 58+ React components
โ”‚
โ”œโ”€โ”€ ๐Ÿ“ฆ packages/
โ”‚   โ”œโ”€โ”€ core/                   # Shared types & utilities
โ”‚   โ”œโ”€โ”€ arcanea-intelligence-os/# AI orchestration
โ”‚   โ””โ”€โ”€ mcp-server/             # MCP Server (30+ tools)
โ”‚
โ”œโ”€โ”€ ๐Ÿ“š book/                    # Library content (17 collections)
โ”‚
โ””โ”€โ”€ ๐Ÿค– .claude/                 # AI assistant context
    โ”œโ”€โ”€ lore/                   # Canonical reference
    โ”œโ”€โ”€ skills/                 # 77 AI skills
    โ””โ”€โ”€ agents/                 # 38 specialized agents

Claude-Arcanea

The Claude-Arcanea package transforms Claude Code into a creative superintelligence.

77 Skills Available

/luminor-intelligence     # Strategic AI from 2125
/starlight-intelligence   # Soul-aligned architecture
/council                  # Multi-agent consultation
/frankx-brand            # Brand voice & guidelines
/suno-ai-mastery         # AI music generation
/oracle-adk              # Oracle agent development
/mcp-architecture        # MCP server design
... and 70 more

38 Specialized Agents

Agent Domain Specialty
@starlight-architect Enterprise AI System design with soul
@frequency-alchemist Music Production Transformative soundscapes
@creation-engine Content & Products Multi-format creation
@luminor-oracle Strategy Future-informed guidance
@greek-philosopher Wisdom Ancient knowledge

Key Features

๐Ÿ”ฎ Oracle Interface


AI-powered wisdom guidance through the Gates. Ask questions, receive insights aligned with your creative journey.

๐Ÿ“š Living Library


200K+ words of practical wisdom. Searchable, categorized, and situation-aware. The texts find you when you need them.

๐ŸŽ“ Academy System


Progress through the Ten Gates. Track your growth from Apprentice to Luminor with structured learning paths.

๐Ÿ›ก๏ธ Guardian Profiles


Meet the Ten Guardians and their Godbeasts. Each pair represents a Gate of creative power to unlock.

๐ŸŽจ Creation Studio


Generate images, music, video, and code with AI. Transform imagination into reality.

๐ŸŒ Creator Community


Connect with fellow creators. Share work, get feedback, collaborate on projects.

Environment Variables

# Supabase (Required)
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_service_key

# AI APIs (Required)
GOOGLE_GENERATIVE_AI_API_KEY=your_gemini_key
ANTHROPIC_API_KEY=your_claude_key

# Optional
OPENAI_API_KEY=your_openai_key

Development

# Type check all packages
pnpm type-check

# Lint the codebase
pnpm lint

# Build for production
pnpm build

# Start production server
pnpm start

# Run E2E tests
pnpm test:e2e

Documentation

Document Description
ARCHITECTURE.md System design & patterns
ARCANEA_CANON.md Universe lore & canon
CONTRIBUTING.md How to contribute
START_HERE.md Complete onboarding guide

Contributing

We welcome contributions from creators and developers alike.

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing)
  5. Open a Pull Request

Please read CONTRIBUTING.md for detailed guidelines.


Community

Website GitHub Discord


License

This project is licensed under the MIT License - see the LICENSE file for details.



"Enter seeking, leave transformed, return whenever needed."


Made with Love by FrankX


     โ˜…  ยท  โ˜…     ยท     โ˜…    ยท    โ˜…
  ยท      โ˜…    ยท    โ˜…      ยท    โ˜…   ยท
    โ˜…        ยท        โ˜…        ยท
       The cosmos awaits your creation

About

Living intelligence that overlays any AI. Ten Guardian intelligences, context that compounds, and the creative civilization OS for creators who build universes.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Sponsor this project

Packages

 
 
 

Contributors