nomic 3.3.0__tar.gz → 3.3.2__tar.gz

nomic-3.3.2/PKG-INFO

@@ -0,0 +1,247 @@
+Metadata-Version: 2.1
+Name: nomic
+Version: 3.3.2
+Summary: The official Nomic python client.
+Home-page: https://github.com/nomic-ai/nomic
+Author: nomic.ai
+Author-email: support@nomic.ai
+License: UNKNOWN
+Platform: UNKNOWN
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Description-Content-Type: text/markdown
+Provides-Extra: local
+Provides-Extra: aws
+Provides-Extra: all
+Provides-Extra: dev
+
+<h1 align="center">Nomic Atlas Python Client</h1>
+<h3 align="center">Explore, label, search and share massive datasets in your web browser.</h3>
+<p>This repository contains Python bindings for working with <a href="https://atlas.nomic.ai/">Nomic Atlas</a>, the world’s most powerful unstructured data interaction platform. Atlas supports datasets from hundreds to tens of millions of points, and supports data modalities ranging from text to image to audio to video. </p>
+
+With Nomic Atlas, you can:
+
+- Generate, store and retrieve embeddings for your unstructured data.
+- Find insights in your unstructured data and embeddings all from your web browser.
+- Share and present your datasets and data findings to anyone.
+
+### Where to find us?
+
+[https://atlas.nomic.ai/](https://atlas.nomic.ai/)
+
+
+
+## Table of Contents
+
+- [Quick resources](#quick-resources)
+  - [Example maps](#example-maps)
+- [Features](#features)
+- [Quickstart](#quickstart)
+  - [Installation](#installation)
+  - [Make your first map](#make-your-first-map)
+- [Atlas usage examples](#atlas-usage-examples)
+  - [Access your embeddings](#access-your-embeddings)
+  - [View your data's topic model](#view-your-datas-topic-model)
+  - [Search for data semantically](#search-for-data-semantically)
+- [Documentation](#documentation)
+- [Discussion](#discussion)
+- [Community](#community)
+
+## Quick Resources
+
+<p >
+  Try the <a href="https://colab.research.google.com/drive/1CZBo3LV0FoRTVRN3v068tvNJgbeWpcSX?usp=sharing">:notebook: Colab Demo</a> to get started in Python
+</p>
+
+<p>
+  Read the <a href="https://docs.nomic.ai">:closed_book:	 Atlas Docs</a>
+</p>
+
+<p>
+  Join our <a href="https://discord.gg/myY5YDR8z8">:hut: Discord</a> to start chatting and get help
+</p>
+
+#### Example maps
+
+<a href="https://atlas.nomic.ai/map/twitter">:world_map: Map of Twitter</a> (5.4 million tweets)
+<br> <br>
+<a href="https://atlas.nomic.ai/map/stablediffusion">:world_map: Map of StableDiffusion Generations</a> (6.4 million images)
+<br> <br>
+<a href="https://atlas.nomic.ai/map/neurips">:world_map: Map of NeurIPS Proceedings</a> (16,623 abstracts)
+
+</p>
+
+## Features
+
+Here are just a few of the features which Atlas offers:
+
+- Organize your **text, image, and embedding data**
+- Create **beautiful and shareable** maps **with or without coding knowledge**
+- Have easy access to both **high-level data structures** and **individual datapoints**
+- **Search** millions of datapoints **instantly**
+- **Cluster data** into semantic topics
+- **Tag and clean** your dataset
+- **Deduplicate** text, images, video, audio
+
+
+
+## Quickstart
+
+### Installation
+
+1. Install the Nomic library
+
+```bash
+pip install nomic
+```
+
+2. Login or create your Nomic account:
+
+```bash
+nomic login
+```
+
+3. Follow the instructions to obtain your access token.
+
+```bash
+nomic login [token]
+```
+
+### Make your first map
+
+```python
+from nomic import atlas
+import numpy as np
+
+# Randomly generate a set of 10,000 high-dimensional embeddings
+num_embeddings = 10000
+embeddings = np.random.rand(num_embeddings, 256)
+
+# Create Atlas project
+dataset = atlas.map_data(embeddings=embeddings)
+
+print(dataset)
+```
+
+## Atlas usage examples
+
+### Access your embeddings
+
+Atlas stores, manages and generates embeddings for your unstructured data.
+
+You can access Atlas latent embeddings (e.g. high dimensional) or the two-dimensional embeddings generated for web display.
+
+```python
+# Access your Atlas map and download your embeddings
+map = dataset.maps[0]
+
+projected_embeddings = map.embeddings.projected
+latent_embeddings = map.embeddings.latent
+```
+
+```python
+print(projected_embeddings)
+```
+
+```
+# Response:
+id 	x 	y
+0 	9.815330 	-8.105308
+1 	-8.725819 	5.980628
+2 	13.199472 	-1.103389
+... 	... 	... 	...
+```
+
+```python
+print(latent_embeddings)
+```
+
+```
+# Response:
+n x d numpy.ndarray where n = number of datapoints and d = number of latent dimensions
+```
+
+### View your data’s topic model
+
+Atlas automatically organizes your data into topics informed by the latent contents of your embeddings. Visually, these are represented by regions of homogenous color on an Atlas map.
+
+You can access and operate on topics programmatically by using the `topics` attribute
+of an AtlasMap.
+
+```python
+# Access your Atlas map
+map = dataset.maps[0]
+
+# Access a pandas DataFrame associating each datum on your map to their topics at each topic depth.
+topic_df = map.topics.df
+
+print(map.topics.df)
+
+```
+
+```
+Response:
+
+id topic_depth_1 topic_depth_2
+0 Oil Prices mergers and acquisitions
+1 Iraq War Trial of Thatcher
+2 Oil Prices Economic Growth
+... ... ... ...
+9997 Oil Prices Economic Growth
+9998 Baseball Giambi's contract
+9999 Olympic Gold Medal European Football
+
+```
+
+### Search for data semantically
+
+Use Atlas to automatically find nearest neighbors in your vector database.
+
+```python
+# Load map and perform vector search for the five nearest neighbors of datum with id "my_query_point"
+map = dataset.maps[0]
+
+with dataset.wait_for_dataset_lock():
+  neighbors, _ = map.embeddings.vector_search(ids=['my_query_point'], k=5)
+
+# Return similar data points
+similar_datapoints = dataset.get_data(ids=neighbors[0])
+
+print(similar_datapoints)
+```
+
+```
+Response:
+
+Original query point:
+"Intel abandons digital TV chip project NEW YORK, October 22 (newratings.com) - Global semiconductor giant Intel Corporation (INTC.NAS) has called off its plan to develop a new chip for the digital projection televisions."
+
+Nearest neighbors:
+"Intel awaits government move on expensing options Figuring it's had enough of fighting over options, the chip giant is waiting to see what Congress comes up with."
+"Citigroup Takes On Intel The financial services giant takes over non-memory semiconductor chip production."
+"Intel Seen Readying New Wi-Fi Chips  SAN FRANCISCO (Reuters) - Intel Corp. this week is  expected to introduce a chip that adds support for a relatively  obscure version of Wi-Fi, analysts said on Monday, in a move  that could help ease congestion on wireless networks."
+"Intel pledges to bring Itanic down to Xeon price-point EM64T a stand-in until the real anti-AMD64 kit arrives"
+```
+
+## Background
+
+Atlas is developed by the [Nomic AI](https://home.nomic.ai/) team, which is based in NYC. Nomic also developed and maintains [GPT4All](https://gpt4all.io/index.html), an open-source LLM chatbot ecosystem.
+
+## Discussion
+
+Join the discussion on our [:hut: Discord](https://discord.gg/myY5YDR8z8) to ask questions, get help, and chat with others about Atlas, Nomic, GPT4All, and related topics. Our doors are open to enthusiasts of all skill levels.
+
+## Community
+
+- Blog: [https://blog.nomic.ai/](https://blog.nomic.ai/)
+- Twitter: [https://twitter.com/nomic_ai](https://twitter.com/nomic_ai)
+- Nomic Website: [https://home.nomic.ai/](https://home.nomic.ai/)
+- Atlas Website: [https://atlas.nomic.ai/](https://atlas.nomic.ai/)
+- GPT4All Website: [https://gpt4all.io/index.html](https://gpt4all.io/index.html)
+- LinkedIn: [https://www.linkedin.com/company/nomic-ai](https://www.linkedin.com/company/nomic-ai)
+
+<br>
+
+[Go to top](#)
+
+

{nomic-3.3.0 → nomic-3.3.2}/nomic/dataset.py

@@ -1688,42 +1688,9 @@ class AtlasDataset(AtlasClass):
 
         """
 
-        # Validate data
-        if self.modality == "embedding" and embeddings is None:
-            msg = "Please specify embeddings for updating an embedding project"
-            raise ValueError(msg)
-
-        if self.modality == "text" and embeddings is not None:
-            msg = "Please dont specify embeddings for updating a text project"
-            raise ValueError(msg)
-
-        if embeddings is not None and len(data) != embeddings.shape[0]:
-            msg = (
-                "Expected data and embeddings to be the same length but found lengths {} and {} respectively.".format()
-            )
-            raise ValueError(msg)
-
-        shard_size = 2000  # TODO someone removed shard size from params and didn't update
-        # Add new data
-        logger.info("Uploading data to Nomic's neural database Atlas.")
-        with tqdm(total=len(data) // shard_size) as pbar:
-            for i in range(0, len(data), MAX_MEMORY_CHUNK):
-                if self.modality == "embedding" and embeddings is not None:
-                    self._add_embeddings(
-                        embeddings=embeddings[i : i + MAX_MEMORY_CHUNK, :],
-                        data=data[i : i + MAX_MEMORY_CHUNK],
-                        pbar=pbar,
-                    )
-                else:
-                    self._add_text(
-                        data=data[i : i + MAX_MEMORY_CHUNK],
-                        pbar=pbar,
-                    )
-        logger.info("Upload succeeded.")
-
-        # Update maps
-        # finally, update all the indices
-        return self.update_indices()
+        raise DeprecationWarning(
+            f"The function AtlasDataset.update_maps is deprecated. Use AtlasDataset.add_data() instead."
+        )
 
     def update_indices(self, rebuild_topic_models: bool = False):
         """
@@ -1734,10 +1701,6 @@ class AtlasDataset(AtlasClass):
             rebuild_topic_models: (Default False) - If true, will create new topic models when updating these indices.
         """
 
-        response = requests.post(
-            self.atlas_api_path + "/v1/project/update_indices",
-            headers=self.header,
-            json={"project_id": self.id, "rebuild_topic_models": rebuild_topic_models},
+        raise DeprecationWarning(
+            f"The function AtlasDataset.update_indices is deprecated. Use AtlasDataset.add_data() instead."
         )
-
-        logger.info(f"Updating maps in dataset `{self.identifier}`")

nomic-3.3.2/nomic.egg-info/PKG-INFO

@@ -0,0 +1,247 @@
+Metadata-Version: 2.1
+Name: nomic
+Version: 3.3.2
+Summary: The official Nomic python client.
+Home-page: https://github.com/nomic-ai/nomic
+Author: nomic.ai
+Author-email: support@nomic.ai
+License: UNKNOWN
+Platform: UNKNOWN
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Description-Content-Type: text/markdown
+Provides-Extra: local
+Provides-Extra: aws
+Provides-Extra: all
+Provides-Extra: dev
+
+<h1 align="center">Nomic Atlas Python Client</h1>
+<h3 align="center">Explore, label, search and share massive datasets in your web browser.</h3>
+<p>This repository contains Python bindings for working with <a href="https://atlas.nomic.ai/">Nomic Atlas</a>, the world’s most powerful unstructured data interaction platform. Atlas supports datasets from hundreds to tens of millions of points, and supports data modalities ranging from text to image to audio to video. </p>
+
+With Nomic Atlas, you can:
+
+- Generate, store and retrieve embeddings for your unstructured data.
+- Find insights in your unstructured data and embeddings all from your web browser.
+- Share and present your datasets and data findings to anyone.
+
+### Where to find us?
+
+[https://atlas.nomic.ai/](https://atlas.nomic.ai/)
+
+
+
+## Table of Contents
+
+- [Quick resources](#quick-resources)
+  - [Example maps](#example-maps)
+- [Features](#features)
+- [Quickstart](#quickstart)
+  - [Installation](#installation)
+  - [Make your first map](#make-your-first-map)
+- [Atlas usage examples](#atlas-usage-examples)
+  - [Access your embeddings](#access-your-embeddings)
+  - [View your data's topic model](#view-your-datas-topic-model)
+  - [Search for data semantically](#search-for-data-semantically)
+- [Documentation](#documentation)
+- [Discussion](#discussion)
+- [Community](#community)
+
+## Quick Resources
+
+<p >
+  Try the <a href="https://colab.research.google.com/drive/1CZBo3LV0FoRTVRN3v068tvNJgbeWpcSX?usp=sharing">:notebook: Colab Demo</a> to get started in Python
+</p>
+
+<p>
+  Read the <a href="https://docs.nomic.ai">:closed_book:	 Atlas Docs</a>
+</p>
+
+<p>
+  Join our <a href="https://discord.gg/myY5YDR8z8">:hut: Discord</a> to start chatting and get help
+</p>
+
+#### Example maps
+
+<a href="https://atlas.nomic.ai/map/twitter">:world_map: Map of Twitter</a> (5.4 million tweets)
+<br> <br>
+<a href="https://atlas.nomic.ai/map/stablediffusion">:world_map: Map of StableDiffusion Generations</a> (6.4 million images)
+<br> <br>
+<a href="https://atlas.nomic.ai/map/neurips">:world_map: Map of NeurIPS Proceedings</a> (16,623 abstracts)
+
+</p>
+
+## Features
+
+Here are just a few of the features which Atlas offers:
+
+- Organize your **text, image, and embedding data**
+- Create **beautiful and shareable** maps **with or without coding knowledge**
+- Have easy access to both **high-level data structures** and **individual datapoints**
+- **Search** millions of datapoints **instantly**
+- **Cluster data** into semantic topics
+- **Tag and clean** your dataset
+- **Deduplicate** text, images, video, audio
+
+
+
+## Quickstart
+
+### Installation
+
+1. Install the Nomic library
+
+```bash
+pip install nomic
+```
+
+2. Login or create your Nomic account:
+
+```bash
+nomic login
+```
+
+3. Follow the instructions to obtain your access token.
+
+```bash
+nomic login [token]
+```
+
+### Make your first map
+
+```python
+from nomic import atlas
+import numpy as np
+
+# Randomly generate a set of 10,000 high-dimensional embeddings
+num_embeddings = 10000
+embeddings = np.random.rand(num_embeddings, 256)
+
+# Create Atlas project
+dataset = atlas.map_data(embeddings=embeddings)
+
+print(dataset)
+```
+
+## Atlas usage examples
+
+### Access your embeddings
+
+Atlas stores, manages and generates embeddings for your unstructured data.
+
+You can access Atlas latent embeddings (e.g. high dimensional) or the two-dimensional embeddings generated for web display.
+
+```python
+# Access your Atlas map and download your embeddings
+map = dataset.maps[0]
+
+projected_embeddings = map.embeddings.projected
+latent_embeddings = map.embeddings.latent
+```
+
+```python
+print(projected_embeddings)
+```
+
+```
+# Response:
+id 	x 	y
+0 	9.815330 	-8.105308
+1 	-8.725819 	5.980628
+2 	13.199472 	-1.103389
+... 	... 	... 	...
+```
+
+```python
+print(latent_embeddings)
+```
+
+```
+# Response:
+n x d numpy.ndarray where n = number of datapoints and d = number of latent dimensions
+```
+
+### View your data’s topic model
+
+Atlas automatically organizes your data into topics informed by the latent contents of your embeddings. Visually, these are represented by regions of homogenous color on an Atlas map.
+
+You can access and operate on topics programmatically by using the `topics` attribute
+of an AtlasMap.
+
+```python
+# Access your Atlas map
+map = dataset.maps[0]
+
+# Access a pandas DataFrame associating each datum on your map to their topics at each topic depth.
+topic_df = map.topics.df
+
+print(map.topics.df)
+
+```
+
+```
+Response:
+
+id topic_depth_1 topic_depth_2
+0 Oil Prices mergers and acquisitions
+1 Iraq War Trial of Thatcher
+2 Oil Prices Economic Growth
+... ... ... ...
+9997 Oil Prices Economic Growth
+9998 Baseball Giambi's contract
+9999 Olympic Gold Medal European Football
+
+```
+
+### Search for data semantically
+
+Use Atlas to automatically find nearest neighbors in your vector database.
+
+```python
+# Load map and perform vector search for the five nearest neighbors of datum with id "my_query_point"
+map = dataset.maps[0]
+
+with dataset.wait_for_dataset_lock():
+  neighbors, _ = map.embeddings.vector_search(ids=['my_query_point'], k=5)
+
+# Return similar data points
+similar_datapoints = dataset.get_data(ids=neighbors[0])
+
+print(similar_datapoints)
+```
+
+```
+Response:
+
+Original query point:
+"Intel abandons digital TV chip project NEW YORK, October 22 (newratings.com) - Global semiconductor giant Intel Corporation (INTC.NAS) has called off its plan to develop a new chip for the digital projection televisions."
+
+Nearest neighbors:
+"Intel awaits government move on expensing options Figuring it's had enough of fighting over options, the chip giant is waiting to see what Congress comes up with."
+"Citigroup Takes On Intel The financial services giant takes over non-memory semiconductor chip production."
+"Intel Seen Readying New Wi-Fi Chips  SAN FRANCISCO (Reuters) - Intel Corp. this week is  expected to introduce a chip that adds support for a relatively  obscure version of Wi-Fi, analysts said on Monday, in a move  that could help ease congestion on wireless networks."
+"Intel pledges to bring Itanic down to Xeon price-point EM64T a stand-in until the real anti-AMD64 kit arrives"
+```
+
+## Background
+
+Atlas is developed by the [Nomic AI](https://home.nomic.ai/) team, which is based in NYC. Nomic also developed and maintains [GPT4All](https://gpt4all.io/index.html), an open-source LLM chatbot ecosystem.
+
+## Discussion
+
+Join the discussion on our [:hut: Discord](https://discord.gg/myY5YDR8z8) to ask questions, get help, and chat with others about Atlas, Nomic, GPT4All, and related topics. Our doors are open to enthusiasts of all skill levels.
+
+## Community
+
+- Blog: [https://blog.nomic.ai/](https://blog.nomic.ai/)
+- Twitter: [https://twitter.com/nomic_ai](https://twitter.com/nomic_ai)
+- Nomic Website: [https://home.nomic.ai/](https://home.nomic.ai/)
+- Atlas Website: [https://atlas.nomic.ai/](https://atlas.nomic.ai/)
+- GPT4All Website: [https://gpt4all.io/index.html](https://gpt4all.io/index.html)
+- LinkedIn: [https://www.linkedin.com/company/nomic-ai](https://www.linkedin.com/company/nomic-ai)
+
+<br>
+
+[Go to top](#)
+
+

{nomic-3.3.0 → nomic-3.3.2}/setup.py

@@ -6,12 +6,28 @@ from setuptools import setup, find_packages
 
 description = "The official Nomic python client."
 
+# Read README.md and remove tables and images
+with open("README.md") as f:
+    content = f.read()
+    # Remove table sections including content
+    while "<table>" in content and "</table>" in content:
+        start = content.find("<table>")
+        end = content.find("</table>") + 8
+        content = content[:start] + content[end:]
+    # Remove img tags and content
+    while "<img" in content and ">" in content:
+        start = content.find("<img")
+        end = content.find(">", start) + 1
+        content = content[:start] + content[end:]
+    long_description = content
+
 setup(
     name="nomic",
-    version="3.3.0",
+    version="3.3.2",
     url="https://github.com/nomic-ai/nomic",
     description=description,
-    long_description=description,
+    long_description=long_description,
+    long_description_content_type="text/markdown",
     packages=find_packages(include=["nomic", "nomic.*"]),
     author_email="support@nomic.ai",
     author="nomic.ai",

nomic-3.3.0/PKG-INFO

@@ -1,18 +0,0 @@
-Metadata-Version: 2.1
-Name: nomic
-Version: 3.3.0
-Summary: The official Nomic python client.
-Home-page: https://github.com/nomic-ai/nomic
-Author: nomic.ai
-Author-email: support@nomic.ai
-License: UNKNOWN
-Platform: UNKNOWN
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Programming Language :: Python :: 3
-Provides-Extra: local
-Provides-Extra: aws
-Provides-Extra: all
-Provides-Extra: dev
-
-The official Nomic python client.
-

nomic-3.3.0/nomic.egg-info/PKG-INFO

@@ -1,18 +0,0 @@
-Metadata-Version: 2.1
-Name: nomic
-Version: 3.3.0
-Summary: The official Nomic python client.
-Home-page: https://github.com/nomic-ai/nomic
-Author: nomic.ai
-Author-email: support@nomic.ai
-License: UNKNOWN
-Platform: UNKNOWN
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Programming Language :: Python :: 3
-Provides-Extra: local
-Provides-Extra: aws
-Provides-Extra: all
-Provides-Extra: dev
-
-The official Nomic python client.
-