Unoffical Notion AI API
Project description
NotionAI
NotionAI is an unofficial NotionAI API that provides a Python SDK and a Chrome extension.
NotionAI Chrome Extension
The NotionAI Chrome Extension is an open-source tool that allows you to access the NotionAI API from any input field in Chrome. You can find the source code in the notionai-chrome directory, and download the extension from the Chrome Web Store.
NotionAI Chrome Extension Demo
NotionAI Python SDK
The NotionAI Python SDK is a wrapper for the NotionAI APIs with Python bindings, simplifying integration of NotionAI solutions into your projects.
Features
- Full APIs from Notion AI
- Support stream response
API
All NotionAI functionalities are supported. Check out the notionai.py file to see all the available APIs.
Basic API Shortcuts
APIs like blog_post
, help_me_write
, help_me_edit
, and summarize
are shortcuts for the basic APIs.
Advanced APIs
We also support advanced APIs that allow you to dispatch by parameters:
writing_with_topic
Writing for special topic Args: topic (TopicEnum): the special topic prompt (str): prompt for writing Example: ao = NotionAI(token) ai.writing_with_topic(TopicEnum.blog_post, "Please help to introduce Notion")
writing_with_prompt
Writing with special prompt, like summarize, explain_this, improve_writing Args: prompt_type (PromptTypeEnum): special prompt context (str): the context for your writing Example: ai = NotionAI(token) ai.writing_with_prompt(PromptTypeEnum.summarize, "I am a student")
translate
Translate the text Args: language (TranslateLanguageEnum): target language context (str): context to translate Example: ai = NotionAI(token) ai.translate(TranslateLanguageEnum.Chinese, "I am a student")
change_tone
Change the tone of your context Args: context (str): context to change tone (ToneEnum): target tone Returns: str: Response from NotionAI Example: ai = NotionAI(token) ai.change_tone("I am a student", ToneEnum.professional)
Usage
Install
pip install --upgrade notionai-py
Get Notion Token and Workspace ID
To use the NotionAI Python SDK, you need to obtain a Notion token. You can do this by following these steps:
- Open Chrome or Firefox DevTools
- Find Cookies and copy the value for
token_v2
- Find the
spaceId
of your Notion workspace
Examples
Check out the examples directory for usage examples.
- Basic
import os
from notionai import NotionAI
TOKEN = os.getenv("NOTION_TOKEN")
SPACE_ID = os.getenv("NOTION_SPACE_ID")
def main():
ai = NotionAI(TOKEN, SPACE_ID)
res = ai.blog_post("write a blog about the meaning of life")
print(res)
if __name__ == "__main__":
main()
- Stream API
import os
import sys
from notionai import NotionAI
TOKEN = os.getenv("NOTION_TOKEN")
SPACE_ID = os.getenv("NOTION_SPACE_ID")
def main():
ai = NotionAIStream(TOKEN, SPACE_ID)
res = ai.blog_post("write a blog about the meaning of life")
for item in res:
sys.stdout.write(item)
if __name__ == "__main__":
main()
- WebUI
Check out the webui directory for instructions on how to use the NotionAI Python SDK with a web user interface.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for notionai_py-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3aba387b621212c15717e4c2f5284518470f515ba58973ce138e6073774f79c4 |
|
MD5 | 9f0df2de6afdd2f89d5b8da5b308d679 |
|
BLAKE2b-256 | 6dca93c9cb1f25d46d7b3356691ee95eaaef3dd2315fbb9da33a7ac2546b163f |