This project is about simplifying the note taking, the idea dropping, etc. Thanks to a simple iOS Shortcuts, you capture a little piece of audio and it is brought to Notion and enriched with valuable insight, based on your expectations. It could be used to:

• maintain a personal diary with external feedback,
• draft idea of projects,
• log your daily work and never forget the followup,
• add tasks to your todolist with informations about preparation,
• log your dreams and get interpretation,
• draft an article for a blog...

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

You need Python 3.8 or later to run this project. You can check your Python version by running:

python --version

Clone the repository to your local machine:

git clone [email protected]:pezzos/Whisper-to-Notion.git   

Navigate into the project directory:

cd Whisper-to-Notion

Run the install.sh script as root

sudo ./install.sh

Before running the program, you need to set the following environment variables:

NOTION: Your Notion token
OPENAI: You OpenAI API Key

You can set these variables in your shell, or you can add them to a .env file in the project root.

vim .zshrc
# then add the following:
export OPENAI="sk-youropenai-api-key"

You also neeed to create your config.json:

mv config.json.template config.json
# then update it according to your setup

This file is filed with some example you can use. The first destination is "Default", it means to be used only when you try to take a note but no keyword matches the other destinations. This way, you won't loose any request. Keep in mind that each Notion DB (see: db_id) has fields described in this file and you MUST respect the same name in your Notion DB in order to have it works. For now, the available fields are:

• Concept: to describe the concept of an idea, a project
• Date: the current date
• Draft: write a draft for an article
• Events: the events listed in the text
• Excerpt: Create an excerpt/meta-description with keywords
• Followup: followup suggestions from the tasks in the text
• Goals: to describe the goals of an idea, a project
• Improvements: to describe what could be improved from an idea
• Input: the input received (the sentence until the keyword trigger is removed)
• Interpretation: Interprete a dream
• Keywords: Found keywords usefull for a topic
• Mood: the mood(s) detected in the text
• Name: a name to sumup the content
• Preparation: suggest ideas to prepare a task easily
• Reading: Find further reading about a topic
• Recommendations: suggest ideas to improve yourself from your current mood and events
• Results: the expected results of an idea
• Target: Describe target audience for a topic
• Tasks: extracts the tasks from a text
• Title: give a motivational title to an idea, a project
• Weather

And for technical reasons, some fields are dependant from other and should be listed before the required ones:

• Followup requires Tasks
• Preparation requires Tasks
• Recommendations requires Mood and Events

To run the program, use the following command:

python3 -m venv env
source env/bin/activate  # On Windows, use `.\env\Scripts\activate`
pip install -r requirements.txt
python main.py

To send a file to the server:

curl -F file=@./test.txt -X POST http://127.0.0.1:5000/

Note: this should be done through a Shorcuts within iOS or MacOS

For now, this script is only usable locally. So, the Shortcut must run on the same computer as this script.

The Shortcut to use it locally is available there: Shortcut: Whisper-to-Notion

Alexandre 'Pezzos' Pezzotta

This project is licensed under the MIT License - see the LICENSE.md file for details

{'object': 'error', 'status': 400, 'code': 'validation_error', 'message': 'Recommendations is not a property that exists.', 'request_id': 'some-caracters'}

It means the field you add in the config.json has a different name from your Notion DB, please update your Notion DB.

• Fallback to a default config if no config is found
• Make it run from a server (not only locally)
• Create a new endpoint called "hello"
• Add logic in the Shortcuts to search first on localhost, then on the same network, then on the domain name > Complex by now because "Get Content" fails the shortcut if the server is unavailable
• Return a success with more information about what happened, mainly what Notion DB was involved
• From the success, display more info into Shortcuts
• Fix issue with splitting the input
• Remove accents in keyword when compared
• If no keyword matches, find the intention
• Add a way to ask for a detailled search
• Add a way to directly ask to GPT and save the output to Notion
• Add a todo and done basket handled thanks to a cron tab launching a dedicated workflow
• Clean automatically m4a (not txt) if they are done to reduce disk usage
• Prepare Notion templates to ease the installation
• Add more examples in a dedicated README.md to understand the different use-cases
• Add more details about how-to setup Notion, the connection and authorization, the database id...
• Allow the endpoint to be called by different users
• Create an endpoint to allow users to connect thanks to their login
• Add a DB to store users and their config
• Move from config.json to multiple config from DB
• Study LangChain or AutoGPT agent for complex tasks such as content creation
• Use Bing AI for search and reduce cost
• Generate synonyms, structure of article, optimize titles
• Output to a Notion page
• Output to something else (like a blog post)
• Input: Weather
• Input: Health and Activity
• Input: Calendar
• Add an UI for users to handle their config
• Add more possibilities: prepare a search about a subject, add a movie or a series to a bucket list, improvements of this very one script