codexu/note-gen

Capture first. Organize later. A local-first Markdown app that turns scattered records into clear notes with AI.

View on GitHub ↗Jump to charts ↓Open shareable report

Summary Information

Updated 16 minutes ago
Added to GitGenius on September 1st, 2025
Created on August 6th, 2024
Open Issues & Pull Requests: 124 (+0)
Number of forks: 956
Total Stargazers: 12,681 (+0)
Total Subscribers: 51 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 40.1 hours
Mean response time: 21.5 days
90th percentile: 83.0 days
Tracked items: 814

How this project is maintained

Around half of the issues opened in the past year never receive a reply. 100% of open issues come from outside the core team, so the backlog reflects real-world use rather than internal planning. Work labelled "bug" is answered fastest, typically in about 21 hours, while "priority: low" waits about 2 months. 62% of tracked open issues have had no activity in three months, so the open count overstates what is actively being worked. Only 18% of issues opened in the past year have been closed.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 105
New in 7 days: 6
Closed in 7 days: 9
Avg open age: 41 days
Stale 30+ days: 86
Stale 90+ days: 67

Recent activity

Opened in 7 days: 6
Closed in 7 days: 8
Comments in 7 days: 2
Events in 7 days: 18

Top labels

  • bug (205)
  • feature (198)
  • duplicate (40)
  • wontfix (14)
  • platform: Linux (13)
  • priority: low (12)
  • platform: Windows (11)
  • question (11)

Most active issues this week

Detailed Description

Note-gen is a Python-based repository designed to automatically generate notes from various input sources, primarily focusing on YouTube videos and PDFs. It leverages a combination of Large Language Models (LLMs) – specifically OpenAI's GPT models – speech-to-text technology (Whisper), and document parsing libraries to create concise and informative summaries. The core goal is to streamline the note-taking process, saving users time and effort while ensuring they capture key information.

The repository's functionality is built around several key components. First, it utilizes OpenAI's Whisper for transcribing audio from YouTube videos. This transcription forms the basis for the note generation process. For PDFs, it employs libraries like PyPDF2 and potentially others (depending on the PDF's structure) to extract text content. Once the text is available, it's then fed into a GPT model (configurable via environment variables, defaulting to gpt-3.5-turbo) with a carefully crafted prompt. This prompt instructs the LLM to summarize the content, identify key topics, and present the information in a structured format. The user can customize the prompt to influence the style and detail of the generated notes.

A significant feature of note-gen is its modular design. The code is organized into distinct modules responsible for specific tasks: transcription, PDF parsing, prompting the LLM, and output formatting. This modularity makes the code more maintainable, testable, and extensible. It also allows for easier integration with other tools or services. The repository includes example scripts demonstrating how to use these modules for both YouTube video summarization and PDF note generation. Configuration is largely handled through environment variables, allowing users to specify their OpenAI API key, preferred GPT model, and other parameters without modifying the core code.

The project supports different output formats. Currently, it primarily generates notes in Markdown format, which is widely used for documentation and note-taking. This makes the generated notes easily readable and editable in various text editors and note-taking applications. The Markdown output includes headings, bullet points, and other formatting elements to enhance readability and organization. Future development could potentially include support for other output formats like plain text, HTML, or even more structured formats like JSON.

Beyond the core functionality, the repository includes helpful utilities like a `requirements.txt` file for easy dependency installation and a `README.md` file providing clear instructions on how to set up and use the tool. The author actively maintains the repository, addressing issues and incorporating improvements based on user feedback. While still under development, note-gen represents a practical and efficient solution for automating the tedious task of note-taking from diverse sources, leveraging the power of modern AI technologies. It's a valuable tool for students, researchers, and anyone who needs to quickly extract and summarize information from lengthy audio or text content.