Skip to content

Welcome to ChronoScope! ⏰

Transform Your Documents Into Beautiful Timelines

ChronoScope uses AI to extract career events from resumes and documents, creating interactive timelines for portfolios, job applications, and career retrospectives.

Get Started in 5 Minutes View Features

What is ChronoScope?

ChronoScope is an intelligent timeline builder that turns ordinary documents into extraordinary visual stories. Upload your resume, cover letters, or personal documents, and watch as AI extracts key events to create a comprehensive timeline of your journey.

ChronoScope Main Interface

ChronoScope's clean, intuitive interface

Why Choose ChronoScope?

  • 🤖 AI-Powered Extraction

    Advanced language models automatically identify events, dates, locations, and relationships from your documents with high accuracy.

    Learn more

  • 📈 Interactive Visualizations

    Beautiful Plotly-based timelines with filtering, zooming, and rich tooltips. See your life story come alive.

    Visualization Guide

  • ✅ Quality Validation

    Built-in validation checks detect missing data, suspicious dates, and low confidence scores. Gold standard comparison for measuring extraction quality.

    Validation Process

  • 🔒 Privacy First

    Your documents stay on your machine. Document text is sent to OpenAI API for AI-powered extraction. All timeline data stored locally.

    Privacy Details

  • 📝 Personal Notes

    Capture thoughts, insights, and context alongside your timeline with persistent note-taking functionality.

    Using Notes

  • 🎨 Professional Design

    Clean, modern interface with progressive disclosure. Simple for beginners, powerful for experts.

    Advanced Features

Quick Start Guide

Follow these three simple steps to create your first timeline:

1. Install ChronoScope

# Clone the repository
git clone https://github.com/yourusername/chronoscope.git
cd chronoscope

# Create virtual environment and install dependencies
python3 -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt

2. Configure API Key

# Add your OpenAI API key
echo 'OPENAI_API_KEY = "sk-your-key-here"' > .streamlit/secrets.toml

Getting an OpenAI API Key

Don't have an API key? Get one at platform.openai.com. The free tier is sufficient for getting started.

3. Launch the App

streamlit run timeline-mvp-pipeline.py

Your browser will automatically open to http://localhost:8501 🎉

Detailed Installation Guide →

How It Works

graph LR
    A[📄 Upload Document] --> B[🤖 AI Analysis]
    B --> C[📅 Event Extraction]
    C --> D[✅ Validation]
    D --> E[📊 Visualization]
    E --> F[💾 Export]

    style A fill:#667eea,stroke:#764ba2,stroke-width:2px,color:#fff
    style B fill:#667eea,stroke:#764ba2,stroke-width:2px,color:#fff
    style C fill:#667eea,stroke:#764ba2,stroke-width:2px,color:#fff
    style D fill:#667eea,stroke:#764ba2,stroke-width:2px,color:#fff
    style E fill:#667eea,stroke:#764ba2,stroke-width:2px,color:#fff
    style F fill:#667eea,stroke:#764ba2,stroke-width:2px,color:#fff
  1. Upload Your Document - Drop in resumes, cover letters, or any text document
  2. AI Analyzes Content - Document type is automatically detected
  3. Events Are Extracted - Dates, locations, people, and descriptions are identified
  4. Quality Validation - Confidence scores and validation checks ensure accuracy
  5. Interactive Timeline - Explore your timeline with powerful filtering and visualization
  6. Export & Share - Save your timeline in multiple formats

See Full Workflow →

Track Your Professional Journey

  • Work positions and promotions
  • Skills and certifications
  • Projects and achievements
  • Career transitions and growth

Perfect for: Job applications, performance reviews, career planning

Document Your Education

  • Degrees and coursework
  • Research projects and publications
  • Conferences and presentations
  • Academic honors and awards

Perfect for: Grant applications, CV preparation, tenure reviews

Preserve Your Memories

  • Life milestones and achievements
  • Travel and experiences
  • Relationships and family events
  • Personal growth moments

Perfect for: Memoirs, family history, personal reflection

Visualize Project Evolution

  • Project phases and deliverables
  • Team changes and roles
  • Milestones and deadlines
  • Learnings and outcomes

Perfect for: Team retrospectives, project reports, case studies

What's New

Latest Features (v1.0 Beta)

  • ✅ Multi-Document Processing - Upload and process multiple files at once
  • ✅ Gold Standard Validation - Quantitative quality metrics with precision/recall
  • ✅ User Notes System - Persistent note-taking with metadata tracking
  • ✅ Advanced Filtering - Filter by date range, tags, confidence, priority
  • ✅ Enhanced Tooltips - Rich hover details with professional formatting
  • 🚧 PDF Export - Coming soon!
  • 🚧 Multi-User Support - Planned for v2.0

View Full Changelog

Documentation Structure

New Users Start Here:

User Guides:

Features & Advanced Topics:

Troubleshooting:

Developer Documentation:

Community & Support

Need Help?

Ready to Get Started?

Transform your story into a timeline
Made with ❤️ by the ChronoScope Team