YC Trace - Startup Growth Analytics Platform

YC Trace is a comprehensive analytics platform designed to help startups track, visualize, and analyze their key metrics using AI-powered insights.

Features

• AI-Powered Analytics: Natural language queries for startup metrics using LangChain and FAISS
• Comprehensive Metrics Tracking:
  • Financial metrics (revenue, expenses, profit margins)
  • User metrics (growth, churn, engagement)
  • Business metrics (CAC, LTV, runway)
• Interactive Visualizations: Real-time dashboards using Plotly
• FastAPI Backend: High-performance API with SQLAlchemy ORM

Project Structure

src/
├── backend/
│   ├── ai_assistant.py    # AI query processing using LangChain
│   ├── database.py        # Database configuration and operations
│   ├── main.py           # FastAPI application entry point
│   ├── models.py         # SQLAlchemy database models
│   ├── routes.py         # API endpoints
│   ├── schemas.py        # Pydantic models for request/response
│   └── visualizations.py  # Plotly-based metric visualizations
└── frontend/            # React-based frontend (to be implemented)

Setup Instructions

1. Create and activate a virtual environment:

python -m venv venv
.\venv\Scripts\activate  # Windows

2. Install backend dependencies:

cd src/backend
pip install -r requirements.txt

3. Run the FastAPI server:

python main.py

The API will be available at http://localhost:8000

API Documentation

Once the server is running, visit:

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

Key Endpoints

• /startups/: Create and manage startup profiles
• /metrics/: Track and retrieve startup metrics
• /ai/query: Natural language queries for startup analysis
• /visualizations/: Generate metric dashboards

Environment Variables

Create a .env file in the backend directory with:

DATABASE_URL=sqlite:///./yctrace.db  # For development
OPENAI_API_KEY=your_api_key_here      # Required for AI features

License

MIT