notion-qa  by hwchase17

Question-answering system for Notion databases

created 2 years ago
2,160 stars

Top 21.3% 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

11 months ago

Responsiveness

Inactive

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

Explore Similar Projects

Starred by Chip Huyen Chip Huyen(Author of AI Engineering, Designing Machine Learning Systems) and Elie Bursztein Elie Bursztein(Cybersecurity Lead at Google DeepMind).

LightRAG by HKUDS

1.0%
19k
RAG framework for fast, simple retrieval-augmented generation
created 10 months ago
updated 23 hours ago
Feedback? Help us improve.