Convelyze

Convelyze is a powerful web application that visualizes your ChatGPT usage, providing comprehensive analytics and insights into your conversations.

Key Features

• 📊 Comprehensive Analytics: Track conversations, messages, GPT usage, model usage, and more.
• 🧩 Monthly Model Breakdowns & Cost Estimation: View ChatGPT token usage with monthly model breakdowns, estimated costs, and compare API pricing.
• 🔒 Privacy First: All data is processed client-side for maximum security. Your conversations stay private.
• 🖥️ Open Source: The project is open source, allowing for community contributions and transparency.
• 🌓 Light & Dark Mode: Seamlessly switch between light and dark themes for comfortable viewing in any environment.
• 📈 Interactive Visualizations: Includes activity calendars, usage timelines, and various charts for in-depth analysis.

Detailed Metrics

• 💬 Total Conversations and Messages
• 🤖 Total GPTs Used and GPT Messages
• 🗣️ Total Voice Messages
• 🖼️ Total Images Generated
• 🗄️ Total Archived Conversations
• 📅 Most Chatty Day
• ⏱️ Time Spent on ChatGPT
• 📊 Average Daily Message Count
• 📆 Activity Calendar
• 👥 Role-Based Message Count (Overall, GPTs, Voice)
• 🕰️ Shift-Wise Message Count
• 🧠 Model-Wise Message Count
• 📈 Usage Timeline
• 🔄 Default Model Slug Count
• ✅ AI Message Status
• 🔧 Model Adjustments Count
• 📎 User Attachment Mime Type Count
• 🛠️ Tool Usage Statistics:
  • 💾 Memory Usage
  • 🐍 Code Interpreter Usage
  • 🌐 Browser Tool Usage
• 🌍 Network Location Data
• 🛑 Interrupted Response Count

How to Use

1. Export Your ChatGPT Data:

   • Go to chatgpt.com
   • Open Profile -> Settings -> Data controls
   • Click on 'Export data'

2. Receive Export Email:

   • Wait for an email from OpenAI with your data export
   • This may arrive within minutes or take up to a few weeks

3. Upload and Analyze:

   • Extract the zip file from the email
   • Upload the conversations.json file to the Convelyze dashboard
   • View your personalized ChatGPT usage analysis

Tech Stack

• Frontend: React.js with Next.js framework
• Styling: Tailwind CSS for responsive design
• Data Visualization: Recharts library
• File Handling: react-dropzone for file uploads
• UI Components:
  • Custom components (MetricCard, GlassCard, etc.)
  • shadcn/ui library components
• Icons: Lucide React icons
• Export Functionality: html2canvas for exporting dashboard as an image
• Animations: react-confetti for celebratory effects

How to Run Locally

To run Convelyze locally, follow these steps:

1. Clone the Repository:

   git clone https://github.com/meetpateltech/convelyze.git
   cd convelyze

2. Install Dependencies: Convelyze uses Bun as the package manager. If you don't have Bun installed, you can install it here.

   bun install

3. Run the Application: To start the local development server, run:

   bun run dev

4. Open the Application: Once the server is running, open your browser and go to http://localhost:3000 to see the application.

Contributing

Convelyze is open source, and contributions are welcome! If you would like to contribute, follow these steps:

1. Fork the Repository: Create a copy of the repository under your own GitHub account.

2. Create a Branch: Make a new branch for your feature or bug fix.

   git checkout -b my-new-feature

3. Commit Your Changes: After making your changes, commit them with a descriptive message.

   git commit -m "Add new feature"

4. Push to Your Branch: Push your branch to GitHub.

   git push origin my-new-feature

5. Submit a Pull Request: Open a pull request and describe your changes.

6. Code Review: The maintainers will review your changes, provide feedback, and hopefully merge your changes into the main branch.

Reporting Issues

If you encounter any problems while using Convelyze, feel free to:

1. Create an Issue: Open an issue on the GitHub repository.
2. Describe the Problem: Clearly explain the issue, including steps to reproduce if applicable.
3. Submit the Issue: The maintainers will review and address it as soon as possible.