PERPETUA 🌀

The Infinite Thought Engine

"Perpetua never stops. Neither should your curiosity."

Perpetua is an AI-powered exploration engine that transforms how you research, learn, and create. Give it any question or curiosity, and watch as it autonomously discovers, questions, solves, challenges, searches, imagines, and builds — endlessly.

Built with Claude's Extended Thinking and Computer Use capabilities.

Traditional AI:

You: "Research quantum computing"
AI: [Gives you a summary]
You: [Still need to do all the work]

Perpetua:

You: "Research quantum computing applications in finance"
Perpetua:
  → Autonomously explores the topic
  → Finds deeper problems and questions
  → Generates solutions
  → Challenges assumptions
  → Researches the web
  → Imagines possibilities
  → Creates artifacts

[Come back to dozens of insights and working prototypes]

1. 🔍 DISCOVERING - Research and explore the topic
2. 🎯 CHASING - Find deeper problems worth pursuing
3. 💡 SOLVING - Generate solutions and approaches
4. ⚡ CHALLENGING - Question assumptions and play devil's advocate
5. ❓ QUESTIONING - Ask probing questions for deeper understanding
6. 🔎 SEARCHING - Deep web research and synthesis
7. 💭 IMAGINING - Creative "what if" scenarios and possibilities
8. 🏗️ BUILDING - Create tangible artifacts (code, docs, prototypes)

Then the cycle repeats, going deeper each time.

• Auto-Pilot Mode - Start a journey, walk away, come back to results
• Configurable Journey Length
  • Quick (4 stages) - Fast exploration
  • Standard (8 stages) - Balanced depth
  • Deep (12 stages) - Comprehensive analysis
  • Thorough (16 stages) - Maximum insight
  • Manual Mode - Continue until you decide to stop
• Real-time Progress - Watch each stage unfold
• Journey History - Complete timeline of all explorations

• AI-Powered Recommendations - Claude analyzes your journey and suggests the best format
• Content Type Detection - Automatically identifies if your journey is narrative, technical, or visual
• Confidence Scoring - Shows recommendation strength

Static Templates (Instant Generation):

• 📊 Report - Professional document with navigation, PDF export
• 📚 Wiki - Reference-style documentation
• 📖 Literature - ✨ NEW: Book/speech-style narrative with:
  • Steve Jobs Presentation Style - Conversational, inspiring storytelling
  • AI-Generated Titles - Compelling, memorable titles and subtitles
  • Speech Optimization - Perfect for text-to-speech and podcasts
  • Download as TXT, Markdown, or PDF

AI-Generated Templates (Custom, Interactive):

• 🌐 Website - Multi-page interactive website
• 🎤 Presentation - Reveal.js slides with animations
• ⏱️ Timeline - D3.js interactive timeline
• 🗺️ Mind Map - Force-directed graph visualization
• 🎨 LinkedIn Carousel - ✨ NEW: Social media-ready carousel posts
• 📱 LinkedIn Content - ✨ NEW: Professional posts, articles, and threads in Steve Jobs style

• Animated Headers - Dynamic patterns and moving objects
• Custom Color Schemes - Brand-aligned or journey-specific palettes
• Typography Presets - Professional font combinations
• Spacing & Layout - Consistent, beautiful proportions

• Beautiful Artifacts - Code, documents, visualizations, mind maps
• Multiple Export Formats - PDF, HTML, Markdown, Plain Text
• Infinite Zoom - Click any insight to explore it deeply (coming soon)
• Thought Forks - Explore multiple parallel paths simultaneously (coming soon)

Perpetua follows Scandinavian design principles:

• Minimalism - Clean, uncluttered interfaces
• Functionality - Every element serves a purpose
• Natural Beauty - Soft colors inspired by Nordic landscapes
• Quality - Craftsmanship in every detail
• Light - Generous whitespace and breathing room
• Timelessness - Design that lasts

Built with:

• Electron (desktop framework)
• React 18 + TypeScript (UI)
• Claude SDK (AI engine with Extended Thinking & Computer Use)
• TailwindCSS (styling)
• Framer Motion (animations)
• SQLite (local data storage)

Powered by:

• Claude Sonnet 4.5 (Anthropic's latest model)
• Extended Thinking (deep reasoning)
• Computer Use (autonomous web browsing)
• Prompt Caching (efficiency)

• PROJECT.md - Complete project overview
• ROADMAP.md - Detailed 3-month build plan
• DESIGN-SYSTEM.md - Scandinavian design principles
• ARCHITECTURE.md - Technical architecture
• MILESTONES.md - Progress tracking

macOS:

1. Download the latest release from Releases
2. Move Perpetua.app to your Applications folder
3. Open Perpetua
4. Click Settings (⚙️) and add your Anthropic API key
5. Start a journey and explore!

# Clone the repository
git clone https://github.com/Clemens865/Perpetua.git
cd Perpetua

# Install dependencies
npm install

# Set up environment
cp .env.example .env
# Add your ANTHROPIC_API_KEY to .env

# Start development
npm run dev

# Run tests
npm run test

# Build for production
npm run build

# Package for macOS
npm run package:mac

Current Version: 1.0.0 Status: Active Development Last Updated: November 19, 2025

Progress:

• Concept & Planning
• Documentation
• Development Environment
• Claude SDK Integration (Sonnet 4.5, Extended Thinking)
• Core Exploration Engine (8-stage cycle working)
• UI Implementation (Journey creation, stage visualization)
• Page Generation System (AI-powered analysis & templates)
• Literature & LinkedIn Templates (Steve Jobs style)
• Design Language System
• Beta Testing
• Public Launch

Latest Features (v1.0.0):

• ✅ Steve Jobs-style literature generation with compelling titles
• ✅ LinkedIn content templates (carousel, posts, articles)
• ✅ Animated headers with moving patterns
• ✅ Design language system with custom color schemes
• ✅ Journey length controls (Quick/Standard/Deep/Thorough + Manual mode)
• ✅ Report template with PDF export and interactive navigation
• ✅ Presentation template with AI-generated slides
• ✅ Claude-powered page analysis and template recommendations
• ✅ File-based page storage with version history

• Electron + React app running
• Claude SDK integrated
• Basic UI and exploration engine
• First complete cycle works

• Computer Use (autonomous web browsing)
• Artifact creation (all types)
• Journey controls
• Visual polish
• Literature & LinkedIn templates

• Auto-pilot mode
• Advanced features
• Beta testing
• Public launch

See ROADMAP.md for detailed timeline.

Perpetua is currently in early development. We'll open up contributions after the initial launch.

For now, if you have ideas or feedback:

• Open an issue
• Join discussions
• Follow our progress

[To be determined]

Inspired by:

• Anthropic's "Keep X" campaign (Keep Discovering, Keep Building, etc.)
• Steve Jobs' legendary presentation style
• Scandinavian design philosophy
• The desire to make exploration effortless

Built with:

• Anthropic Claude - AI engine
• Electron - Desktop framework
• React - UI library
• Amazing open source tools

• GitHub Issues - Bug reports and feature requests
• GitHub Discussions - General discussion

If you're excited about Perpetua, give us a star ⭐️

It helps us know there's interest and keeps us motivated!

Built with ❤️ and curiosity

"From curiosity to creation, infinitely."