{"id":13705169,"url":"https://github.com/bramses/quoordinates","last_synced_at":"2025-06-14T13:32:26.169Z","repository":{"id":183580312,"uuid":"670379756","full_name":"bramses/quoordinates","owner":"bramses","description":"Use OpenAI Embeddings to visualize Kindle Highlights from Readwise!","archived":false,"fork":false,"pushed_at":"2024-05-14T16:48:36.000Z","size":23341,"stargazers_count":29,"open_issues_count":2,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-02T06:06:18.389Z","etag":null,"topics":["embeddings","future-of-reading","kindle","nomic","openai","readwise","supabase"],"latest_commit_sha":null,"homepage":"https://atlas.nomic.ai/map/2f41176d-366b-4e21-a915-607320cee284/3cdfc12c-dd63-4a08-87ca-063c710379dd","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bramses.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-07-24T23:42:19.000Z","updated_at":"2024-11-27T21:08:30.000Z","dependencies_parsed_at":"2024-05-05T14:23:36.865Z","dependency_job_id":"565e97f2-4fb2-40bb-856a-a52b8e6c2beb","html_url":"https://github.com/bramses/quoordinates","commit_stats":null,"previous_names":["bramses/quoordinates"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bramses/quoordinates","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bramses%2Fquoordinates","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bramses%2Fquoordinates/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bramses%2Fquoordinates/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bramses%2Fquoordinates/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bramses","download_url":"https://codeload.github.com/bramses/quoordinates/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bramses%2Fquoordinates/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259823536,"owners_count":22917081,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["embeddings","future-of-reading","kindle","nomic","openai","readwise","supabase"],"created_at":"2024-08-02T22:00:34.870Z","updated_at":"2025-06-14T13:32:26.128Z","avatar_url":"https://github.com/bramses.png","language":"JavaScript","funding_links":[],"categories":["Tools"],"sub_categories":["AI"],"readme":"# Quoordinates (Quote Coordinates)\n\n[**check out the general purpose PostgresDB prototype version of Quoordinates I'm working on -- Commonbase!!**](https://github.com/bramses/commonbase-prototype)\n\n- Readwise\n- OpenAI Embeddings\n- Nomic\n- PSQL (PostgreSQL)\n\n1. fetch highlights from readwise\n    1. (optional) start at date\n2. upsert data in database\n3. embed highlights with openai\n4. place embeddings into nomic visualization\n\n`embed-into-supabase.js` is a node script that embeds highlights into supabase\n`nomic-viz.py` is a python script that visualizes highlights in nomic\n`readwise-highlights.py` is a python script that fetches highlights from readwise\n\n## Downstream Dependents\n\nThe apps below depend on Quoordinates and display how versatile this technology is:\n\n- [Commonplace Bot](https://github.com/bramses/commonplace-bot) - A Discord Bot where quotes can be surfaced, discussed, and transformed in an MMO like format.\n- [Quo Host](https://github.com/bramses/quo-host/tree/main) - A realtime speech to semantic search to \"higlight within highlight\" surfacer. Sound smarter on podcasts.\n- [Kindle Streamer](https://github.com/bramses/kindle-streamer) - Use OCR on a cron job to take a picture of Kindle, and generate a visual bookmark using DALL-E.\n\n\n## Setup\n\n1. Create a `.env` file with the following variables:\n\n```\nREADWISE_ACCESS_TOKEN=\nSUPABASE_URL=\nSUPABASE_KEY=\nOPENAI_API_KEY=\nOPENAI_ORG=\nDAY_LAST_FETCHED=\nLOG_PATH=\n```\n\n2. Install dependencies\n\n```\npoetry init\npoetry shell\npoetry install\n```\n\nand\n\n```\nnpm install\n```\n\n3. Run the script to get readwise highlights\n\n```\npython readwise-highlights.py\n```\n\n4. Run the script to embed highlights\n\n```\nnode embed-into-supabase.js\n```\n\n5. Run the script to visualize highlights\n\n```\npython nomic-viz.py\n```\n\n## Other\n\nThere are other tools in this repo too!\n- [compile quotes](https://github.com/bramses/quoordinates/blob/main/compile-quotes.js) - use k-means to make a cluster of all quotes from a book and give them topic titles\n- [share-pic](https://github.com/bramses/quoordinates/blob/28a58bcd27ac8a4d3480129f028d282d3bf138c9/share-pic.js#L461) - use a quote, dalle, and cf images to save a quote and image in one eye catching piece\n\n## Images\n\n![Screenshot 2023-07-26 01-46-45](https://github.com/bramses/quoordinates/assets/3282661/b618e3ce-f66b-41a7-ba9d-03b5ef1bd65c)\n![Screenshot 2023-07-26 01-35-19](https://github.com/bramses/quoordinates/assets/3282661/039fc137-7054-4c28-9f2c-39fb4a4c8d2f)\n![Screenshot 2023-07-26 01-35-27](https://github.com/bramses/quoordinates/assets/3282661/efb78a06-1116-4b41-b4c5-e6f1eee6c90d)\n\n![Screenshot 2023-07-28 15-11-18](https://github.com/bramses/quoordinates/assets/3282661/d66e95c1-22a9-42f3-a440-8ba4a926c995)\n![Screenshot 2023-07-28 15-10-35](https://github.com/bramses/quoordinates/assets/3282661/7e32262d-7705-4cc7-b770-9c3bc0444865)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbramses%2Fquoordinates","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbramses%2Fquoordinates","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbramses%2Fquoordinates/lists"}