From d59cad53f3c833ac65d78781c89bae8a28030e9e Mon Sep 17 00:00:00 2001 From: Shreyans Jain Date: Sun, 18 May 2025 18:54:06 +0530 Subject: [PATCH 1/2] chore: new README with archival notice Signed-off-by: Shreyans Jain --- README.md | 230 +++++++++++++++--------------------------------------- logo.svg | 15 ++++ 2 files changed, 78 insertions(+), 167 deletions(-) create mode 100644 logo.svg diff --git a/README.md b/README.md index a9a0ba15..38f807e4 100644 --- a/README.md +++ b/README.md @@ -1,193 +1,89 @@ - -![og image](https://supermemory.ai/og-image.png) - -# Supermemory
- - GitHub stars - - - GitHub forks - - - GitHub contributors - - - Chrome Web Store - -
-
-
-Supermemory - AI second brain for all your saved stuff | Product Hunt + supermemory Logo +

The Memory API for the AI era

+> [!WARNING] +> This repo contains archived code for supermemory v1 and no longer recieves updates or support. +## ๐Ÿง  What is supermemory? -## ๐Ÿ‘€ What is this? +supermemory is a powerful, developer-friendly API that seamlessly integrates external knowledge into your AI applications. It serves as the perfect memory layer for your AI stack, providing semantic search and retrieval capabilities that enhance your models with relevant context. -Supermemory exists to bring contextual knowledge to the age of LLMs. -The vision is to be the universal engine for memory +With supermemory, you can: -LLMs are smart as fuck. but giving them the right context make them even more useful in most contexts. +- **Store and organize knowledge** in a searchable database that understands meaning, not just keywords +- **Enhance AI responses** with accurate, up-to-date information from your data +- **Eliminate hallucinations** by grounding AI outputs in your trusted content +- **Connect to any source** with pre-built integrations for websites, PDFs, images, and more -Think about it - thereโ€™s countless use-cases where LLMs by themselves donโ€™t do much, but giving them the right data can make it a magical experience. +## โœจ Key Features -Right data comes from everywhere. itโ€™s literally with us. at all times. everything we see, hear, touch. is good data, USEFUL data. but then it all comes down to โ€œhow can i search for something within this pool of awesome stuff?โ€ +- **Universal Content Handling**: Automatically process and index content from URLs, PDFs, text, and more +- **Semantic Search**: Find information based on meaning, not just keyword matching +- **Advanced Filtering**: Organize and retrieve information using metadata, categories, and user partitioning +- **Query Enhancement**: Rewriting and reranking for more relevant results +- **Simple Integration**: Clean, consistent API with SDKs for TypeScript and Python -We make the pool, and give the search tools. +## ๐Ÿš€ Getting Started -Thatโ€™s literally all Supermemory does. Every single project in our scope aids in doing one of the two things. +Getting started with supermemory takes just minutes: -Whether itโ€™s organizing personal information, enhancing applications with contextual intelligence, or enabling companies to centralize and retrieve internal knowledge, Supermemory becomes the core infrastructure for transforming scattered data into actionable insights. +1. Sign up at [console.supermemory.ai](https://console.supermemory.ai) +2. Create your API key +3. Start adding and querying content -## Key Features +```javascript +// Install: npm install supermemory +import { supermemory } from 'supermemory'; -- ๐Ÿ’ก **Ideation**: Capture and save ideas effortlessly. -- ๐Ÿ”– **Bookmarks**: Import, organize, and resurface bookmarks when needed. -- ๐Ÿ“‡ **Contacts**: Store and manage information about people you know. -- ๐Ÿฆ **Twitter Bookmarks**: Import and utilize your saved tweets. -- ๐Ÿ” **Powerful Search**: Quickly find any saved information. -- ๐Ÿ’ฌ **Chat with Collections**: Interact with specific knowledge bases. -- ๐Ÿ–ผ๏ธ **Memory refresh**: Contextually shows relevant items for re-learning. -- โœ๏ธ (soon) **Writing Assistant**: Use a markdown editor with AI assistance for content creation. -- ๐Ÿ”’ **Privacy Focused**: Ensures data security and privacy. -- ๐Ÿ  **Self Hostable**: Open source and easy to deploy locally. -- ๐Ÿ”— **Integrations**: Compatible with Telegram, Twitter, Chrome bookmarks, Notion, and more to come. +const client = new supermemory({ + apiKey: 'YOUR_API_KEY', +}); -## Supermemory API -Developers can make apps on top of supermemory using the [API](https://api.supermemory.ai). You can find the documentation here: https://docs.supermemory.ai +// Add content to your knowledge base +await client.memory.create({ + content: "https://en.wikipedia.org/wiki/Artificial_intelligence", + metadata: { + source: "wikipedia", + category: "AI" + } +}); -YOU can build cool stuff with supermemory. -1. Import tools -2. Chat with (insert whatever here) apps -3. Personalisation in existing apps -4. Content management systems +// Query your knowledge base +const results = await client.search.create({ + q: "What are the ethical considerations in AI development?", + limit: 5 +}); +``` -## How do I use this? +## ๐Ÿ“š Documentation -Just go to [supermemory.com](https://supermemory.com) and sign in. +We've created comprehensive documentation to help you get the most out of supermemory: -To use the chrome extension, +- [Quick Start Guide](https://docs.supermemory.ai/quickstart/overview) +- [API Reference](https://docs.supermemory.ai/api-reference) +- [SDK Documentation](https://docs.supermemory.ai/sdks) +- [Use Cases & Examples](https://docs.supermemory.ai/overview/use-cases) -1. Download from [Chrome Web Store](https://chromewebstore.google.com/detail/supermemory/afpgkkipfdpeaflnpoaffkcankadgjfc?authuser=0&hl=en-GB) -2. Pin the supermemory chrome extension and just click on it to save the website. - image +## ๐ŸŒŸ Use Cases -### Importing from integrations (Twitter, Chrome bookmarks, Notion, etc) +supermemory powers a wide range of AI-enhanced applications: -1. Open [Supermemory](https://supermemory.ai) -2. Follow the steps to connect your integrations - image -3. Voila! Now your second brain has all your twitter bookmarks. +- **RAG (Retrieval Augmented Generation)**: Enhance LLM outputs with accurate data +- **Knowledge Bases & Documentation**: Create intelligent, searchable repositories +- **Customer Support**: Build chatbots with access to your support documentation +- **Research Assistants**: Query across papers, notes, and references +- **Content Management**: Organize and retrieve multimedia content semantically -#### Architecture: +## ๐Ÿ’ฌ Support -image +Have questions or feedback? We're here to help: +- Email: [dhravya@supermemory.com](mailto:dhravya@supermemory.com) +- Documentation: [docs.supermemory.ai](https://docs.supermemory.ai) +## ๐Ÿ”„ Updates & Roadmap -Supermemory has three main modules, managed by [turborepo](https://turbo.build): - -#### `apps/web`: The main web UI. - -![image](https://i.dhr.wtf/r/Clipboard_Jan_20,_2025_at_3.19โ€ฏPM.png) - -Built with: - -- [Remix](https://remix.run/) -- [Hono](https://hono.dev/) -- [authkit-remix-cloudflare by Supermemory](https://github.com/supermemoryai/authkit-remix-cloudflare) -- [Drizzle ORM](https://drizzle.team/) -- [TailwindCSS](https://tailwindcss.com) -- [shadcn-ui](https://ui.shadcn.com) -- And some other amazing open source projects like [Plate](https://platejs.org/) and [vaul](https://vaul.emilkowal.ski/) -- Hosted on [Cloudflare Pages](https://pages.cloudflare.com/) - -#### `apps/extension`: Chrome extension - -The [chrome extension](https://supermemory.ai/extension) is one of the most important part of the setup, but is not required.This is to easily add pages to your memory. - -image - -> please rate the extension to improve the rating ๐Ÿ™. - -Built with: - -- [Extension JS](https://extension.js.org) -- [TailwindCSS](https://tailwindcss.com) -- [React](https://react.dev/) - -#### `apps/backend`: This module handles the vector store and AI response generation - -This is where the magic happens! -Built with: - -- [Cloudflare Workers](https://workers.cloudflare.com/) -- [Postgres + Pgvector with Pgvectorscale](https://github.com/timescale/pgvectorscale) -- [Cloudflare Workflows](https://developers.cloudflare.com/queues/) -- [R2 Object storage](https://developers.cloudflare.com/r2/) -- [Markdowner by Supermemory](https://md.dhr.wtf) -- [Cloudflare KV](https://developers.cloudflare.com/kv) -- [mem0](https://app.mem0.ai) - -## Is this free? - -Yes, everything is free & open source. -Supermemory is built by [me](https://dhravya.dev), a college student. My life situations make it very difficult and almost impossible to monetise the product. - -## Star History - -[![Star History Chart](https://api.star-history.com/svg?repos=Dhravya/supermemory&type=Date)](https://star-history.com/#Dhravya/supermemory&Date) - -## Contribute or self host - -Supermemory is design to be set up easily locally and super duper easy to set up ๐Ÿ’ซ - -Please see the [SELF-HOSTING-GUIDE.md](SELF-HOSTING-GUIDE.md) for setup instructions. - -## License - -Supermemory is licensed under the [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International Public License](LICENSE). - -- You can use the code for personal projects, given appropriate attribution. -- For non-commercial use, the code must be open source. -- Please reach out to me if you want to use the code for commercial projects. - -### Contributing - -Contributions are very welcome! A contribution can be as small as a โญ or even finding and creating issues. - -Thanks to all the awesome people who have contributed to supermemory. - - - - -## Sponsors - -We are grateful for the support of our supporters: - - - - - - - -
- - Cloudflare Compute - -
- Cloudflare - Compute - 		- - Vercel One Time - -
- Vercel - One Time - 		- - Coderabbit Monthly - -
- Coderabbit - Monthly ($50) -
- +Stay up to date with the latest improvements: +- [Changelog](https://docs.supermemory.ai/changelog/overview) +- [X](https://x.com/supermemoryai) diff --git a/logo.svg b/logo.svg new file mode 100644 index 00000000..a91e0f68 --- /dev/null +++ b/logo.svg @@ -0,0 +1,15 @@ + + supermemory Logo + + + + + + + + + \ No newline at end of file From ddfb7f248164367379ddefffc465b0684a96e82c Mon Sep 17 00:00:00 2001 From: Shreyans Jain Date: Sun, 18 May 2025 18:59:45 +0530 Subject: [PATCH 2/2] fix: typo Signed-off-by: Shreyans Jain --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 38f807e4..3f61f8da 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ > [!WARNING] -> This repo contains archived code for supermemory v1 and no longer recieves updates or support. +> This repo contains archived code for supermemory v1 and no longer receives updates or support. ## ๐Ÿง  What is supermemory?