notion-qa  by hwchase17

Question-answering system for Notion databases

Created 3 years ago
2,162 stars

Top 20.8% on SourcePulse

GitHubView on GitHub
Project Summary

This repository provides a natural language interface for querying Notion databases, built using LangChain. It allows users to ask questions about their Notion data in plain English, offering a more convenient way to retrieve information compared to traditional database querying methods. The primary audience is users who rely heavily on Notion for data management and seek an intuitive way to access and analyze that information.

How It Works

The project leverages LangChain to process natural language questions and interact with Notion data. It likely involves converting Notion exports (Markdown & CSV) into a format suitable for a language model, then using the model to understand user queries and retrieve relevant information from the Notion database. This approach abstracts away complex database interactions, enabling users to query their data conversationally.

Quick Start & Requirements

  • Install requirements: pip install -r requirements.txt
  • Set OpenAI API key: export OPENAI_API_KEY=....
  • To ask a question: python qa.py "your question here"
  • For Streamlit deployment: main.py (ensure OPENAI_API_KEY is set as a secret environment variable).
  • Data ingestion: Export Notion data as Markdown & CSV, unzip into the repository, and run python ingest.py.
  • Prerequisites: Python, OpenAI API key.

Highlighted Details

  • Natural language querying of Notion databases.
  • Built with LangChain.
  • Supports data ingestion from Notion exports (Markdown & CSV).
  • Includes a Streamlit app for deployment.

Maintenance & Community

No specific information on contributors, sponsorships, or community channels (Discord/Slack) is provided in the README.

Licensing & Compatibility

The README does not specify a license. Compatibility for commercial use or closed-source linking is not mentioned.

Limitations & Caveats

The project relies on an OpenAI API key, incurring potential costs. The README does not detail performance benchmarks, error handling, or specific Notion export limitations. The data used for the example was exported on a specific date and may not reflect current Notion data.

Health Check
Last Commit

1 year ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
1 stars in the last 30 days

Explore Similar Projects

Starred by John Resig John Resig(Author of jQuery; Chief Software Architect at Khan Academy), Jason Huggins Jason Huggins(Creator of Selenium), and
2 more.

instructor-js by 567-labs

0%
756
Typescript tool for structured extraction from LLMs
Created 1 year ago
Updated 9 months ago
Feedback? Help us improve.