--- title: "Quickstart - 5 mins" description: "Learn how to integrate supermemory into your application" --- ## Authentication Head to [supermemory's Developer Platform](https://console.supermemory.ai) built to help you monitor and manage every aspect of the API. All API requests require authentication using an API key. Include your API key as follows: ```bash cURL Authorization: Bearer YOUR_API_KEY ``` ```typescript Typescript // npm install supermemory const client = new supermemory({ apiKey: "YOUR_API_KEY", }); ``` ```python Python # pip install supermemory client = supermemory( api_key="YOUR_API_KEY", ) ``` ## Installing the clients You can use supermemory through the APIs, or using our SDKs ```bash cURL https://api.supermemory.ai/v3 ``` ```bash Typescript npm i supermemory ``` ```bash Python pip install supermemory ``` ## Add your first memory ```bash cURL curl https://api.supermemory.ai/v3/documents \ --request POST \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer SUPERMEMORY_API_KEY' \ -d '{"content": "This is the content of my first memory."}' ``` ```typescript Typescript await client.memory.add({ content: "This is the content of my first memory.", }); ``` ```python Python client.memory.add( content="This is the content of my first memory.", ) ``` This will add a new memory to your supermemory account. Try it out in the [API Playground](/api-reference/manage-memories/add-memory). ## Content Processing When you add content to supermemory, it goes through several processing steps: 1. **Queued**: Initial state when content is submitted 2. **Extracting**: Content is being extracted from the source 3. **Chunking**: Content is being split into semantic chunks 4. **Embedding**: Generating vector embeddings for search 5. **Indexing**: Adding content to the search index 6. **Done**: Processing complete The system uses advanced NLP techniques for optimal chunking: - Sentence-level splitting for natural boundaries - Context preservation with overlapping chunks - Smart handling of long content - Semantic coherence optimization ## Search your memories ```bash cURL curl https://api.supermemory.ai/v3/search \ --request POST \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer SUPERMEMORY_API_KEY' \ -d '{"q": "This is the content of my first memory."}' ``` ```typescript Typescript await client.search.execute({ q: "This is the content of my first memory.", }); ``` ```python Python client.search.execute( q="This is the content of my first memory.", ) ``` Try it out in the [API Playground](/api-reference/search-memories/search-memories). You can do a lot more with supermemory, and we will walk through everything you need to. Next, explore the features available in supermemory Adding memories Searching for items Connecting external sources Explore Features