https://github.com/maxprogram/readspace

Explore your Readwise highlights by semantically searching them and finding similar highlights.
https://github.com/maxprogram/readspace

Last synced: about 2 months ago
JSON representation

Explore your Readwise highlights by semantically searching them and finding similar highlights.

• Host: GitHub
• URL: https://github.com/maxprogram/readspace
• Owner: maxprogram
• Created: 2023-07-20T23:55:08.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2023-08-07T18:29:28.000Z (over 1 year ago)
• Last Synced: 2024-06-02T09:36:59.262Z (5 months ago)
• Language: JavaScript
• Size: 2.3 MB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-readwise - readspace - A semantic search tool for your Readwise highlights. (Tools / Other)

README

        
# Readspace

Explore your Readwise highlights by semantically searching them and finding similar highlights.



Try:

* Asking a question

* Pasting in a passage, highlight, or anything else

* Typing in a topic (no matter how obscure or detailed)

![](public/images/sample.gif)

### Running locally

Requirements:

* [Node.js v18](https://nodejs.org/)

* [A Readwise Access Token](https://readwise.io/access_token) (the app will read your highlights only and never makes any edits)

* [An OpenAI API key](https://platform.openai.com/account/api-keys) (this uses the embeddings API which is very cheap)

Open a Terminal window, then clone repo and run Node server:

```bash

git clone [email protected]:maxprogram/readspace.git

cd readspace

node server.js

```

1. Navigate to [http://localhost:3080](http://localhost:3080) in your browser.

2. In the "Settings" modal, enter your [Readwise Access Token](https://readwise.io/access_token) and [OpenAI API key](https://platform.openai.com/account/api-keys) and click Save.

3. Load your highlights. Depending on how many highlights you have, this may take a while. Give it 5 minutes or so.

4. Explore!

---

Designed and built by [Max Olson](http://maxolson.com)