usecortex-ai 0.2.2__py3-none-any.whl → 0.3.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,136 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: usecortex-ai
3
- Version: 0.2.2
4
- Summary: The official Python SDK for the Cortex AI platform.
5
- Author-email: Nishkarsh Shrivastava <nishkarsh@usecortex.ai>
6
- License: Copyright (c) 2024 Cortex AI
7
-
8
- All Rights Reserved.
9
-
10
- PROPRIETARY AND CONFIDENTIAL
11
-
12
- This software is the proprietary and confidential property of Cortex AI ("the Company").
13
- Permission is hereby granted to authorized users to install and use this software as part of the Cortex AI service, subject to the terms and conditions of the service agreement entered into with the Company.
14
-
15
- You may not, without the express written permission of the Company:
16
-
17
- 1. Copy, modify, or create derivative works of the software.
18
- 2. Distribute, sell, rent, lease, sublicense, or otherwise transfer the software to any third party.
19
- 3. Reverse engineer, decompile, or disassemble the software, except and only to the extent that such activity is expressly permitted by applicable law notwithstanding this limitation.
20
-
21
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
22
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
23
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
24
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
25
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
26
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
27
- SOFTWARE.
28
- Project-URL: Homepage, https://www.usecortex.ai/
29
- Project-URL: Documentation, https://docs.usecortex.ai/
30
- Keywords: cortex,ai,sdk,api,generative ai,rag
31
- Classifier: Development Status :: 4 - Beta
32
- Classifier: Programming Language :: Python :: 3
33
- Classifier: Programming Language :: Python :: 3.10
34
- Classifier: Programming Language :: Python :: 3.11
35
- Classifier: Programming Language :: Python :: 3.12
36
- Classifier: Intended Audience :: Developers
37
- Classifier: Topic :: Software Development :: Libraries :: Python Modules
38
- Classifier: Typing :: Typed
39
- Requires-Python: >=3.10
40
- Description-Content-Type: text/markdown
41
- License-File: LICENSE
42
- Requires-Dist: httpx>=0.24
43
- Requires-Dist: pydantic<3,>=1.10
44
- Dynamic: license-file
45
-
46
- ```
47
- # Introduction
48
-
49
- > You can generate and manage API keys from your Cortex Dashboard. All endpoints require an API key sent as a Bearer token in the Authorization header.
50
-
51
- Welcome to the Cortex SDK API Reference. This section documents every available endpoint and how to interact with them to power AI apps and agents with intelligent memory and retrieval.
52
-
53
- > Base URL: `https://api.usecortex.ai`
54
- >
55
- > Contact us to get your API key at [founders@usecortex.ai](mailto:founders@usecortex.ai)
56
-
57
- ```mdx
58
- Authorization: Bearer <your_api_key>
59
- ```
60
-
61
- ### **Data Ingestion**
62
-
63
- Upload and import content into Cortex from various sources.
64
-
65
- * `/upload/upload_document` — Upload single documents
66
- * `/upload/upload_text` — Upload text/markdown content
67
- * `/upload/upload_app_sources` — Import from workplace apps (Gmail, Slack, etc.)
68
- * `/upload/scrape_webpage` — Scrape and index web content
69
- * `/upload/verify_processing` — Check upload processing status
70
- * `/upload/batch_upload` — Upload multiple files at once
71
-
72
- ### **Search & Query**
73
-
74
- Retrieve answers and information from your knowledge base.
75
-
76
- * `/search/qna` — Main search endpoint with AI-powered responses. Supports optional `metadata` parameter to filter sources by `source_title` or `source_type`.
77
- * `/search/retrieve` — Hybrid search without AI generation. Returns structured search results for custom processing.
78
- – `/search/full-text-search` – Perform a full text search without AI generation. Allows you to use operators like logical `AND`, `OR`
79
-
80
- ### **Knowledge Management**
81
-
82
- Browse, fetch, and manage your knowledge base.
83
-
84
- * `/list/sources` — Browse all indexed sources
85
- * `/list/sources_by_id` — Get specific sources by ID
86
- * `/fetch/fetch_content` — Retrieve file content and download URLs
87
- * `/delete_source` — Remove sources from knowledge base
88
-
89
- ### **Update & Upsert**
90
-
91
- Update existing content and embeddings. If a `source_id` does not exist, these endpoints upsert (create or update).
92
-
93
- * `/upload/update_text` — Upsert markdown/text content by `source_id`
94
- * `/upload/update_document` — Upsert a file/document by `source_id`
95
- * `/upload/update_webpage` — Re-scrape and upsert a webpage by `source_id` and `web_url`
96
- * `/upload/update_embeddings` — Update existing embeddings by `chunk_id` within a batch/source
97
-
98
- ### **Embeddings**
99
-
100
- Manage and query pre-computed embeddings.
101
-
102
- * `/upload/upload_embeddings` — Upload embeddings and get generated `chunk_ids`
103
- * `/embeddings/search` — Vector similarity search; returns nearest `chunk_ids` and scores
104
- * `/embeddings/by-chunk-ids` — Retrieve embedding vectors for specific `chunk_ids`
105
- * `/embeddings/delete` — Delete embeddings by `chunk_id`
106
-
107
- ### **Tenant Management**
108
-
109
- Create and monitor tenants for multi-tenant setups.
110
-
111
- * `/user/create_tenant` — Create a tenant (optionally provide `tenant_id`, or auto-generate)
112
- * `/embeddings/create_embeddings_tenant` — Create an embeddings-only tenant (sets `sub_tenant_id = tenant_id`); use when directly uploading/searching embeddings
113
- * `/tenant/stats` — Get tenant stats (object count, vector dimension, identifiers)
114
-
115
- ### **User Memory**
116
-
117
- Personalize, retrieve, and manage user-specific AI memories for advanced agentic workflows.
118
-
119
- * `/user_memory/list_user_memories` — Browse user memories
120
- * `/user_memory/retrieve_user_memory` — Get specific user memories
121
- * `/user_memory/add_user_memory` — Manually add user-specific memories
122
- * `/user_memory/generate_user_memory` — AI-generated personalized memories
123
- * `/user_memory/delete_user_memory` — Remove user memories
124
-
125
- ## 💡 Best Practices
126
-
127
- * Use **sub-tenants** to support multi-user isolation in B2B use cases.
128
- * Leverage **metadata** (e.g., `source_title`, `source_type` in the QnA API) for fine-grained filtering and agentic retrieval.
129
- * Tune **search\_alpha** and **recency\_bias** to control relevance.
130
- * Enable **highlight\_chunks** for chunk-level citations.
131
-
132
- ---
133
-
134
- ```
135
-
136
- ```