<div align="center">
# Nyx Client SDK
[](https://pypi.org/project/nyx-client)
[](https://github.com/Iotic-Labs/nyx-sdk/blob/main/LICENSE)
[](https://github.com/Iotic-Labs/nyx-sdk/actions/workflows/build.yaml)
[](https://nyx-client.readthedocs.io/en/stable)
[](https://github.com/Iotic-Labs/nyx-sdk)
[](https://discord.gg/zS8pVHjqSf)
🌟 **Nyx Client SDK** offers a simple API for interacting with data in your Nyx network. Subscribe, search and download data from across your federated network with
ease, or if you're a publisher, easily created, update, or delete your existing data products programmatically!
If you're looking for an out of the box experience, try installing [nyx-extras](https://github.com/Iotic-Labs/nyx-sdk/tree/main/nyx_extras), to seamlessly and quickly
build powerful AI applications, to interact with data from your Nyx network!
[](https://iotics.com)
</div>
## 🚧 Status
The Nyx ecosystem is at an early stage of its development, please give us feedback through the [Github issues](https://github.com/Iotic-Labs/nyx-sdk/issues).
## What is the Nyx Client SDK
The Nyx Client SDK is a Python library that provides an API for easy interaction with the Nyx Platform. It enables end users to seamlessly connect their data to the Nyx ecosystem, search for data, subscribe to it, and consume it. With this SDK, users can ultimately build powerful AI applications.
Several examples of SDK usage in an AI context are available:
- [RAG demo examples](https://github.com/Iotic-Labs/nyx-sdk/tree/main/examples)
- `https://[nyx_host]/try-me-now`
See also [What is Nyx](https://github.com/Iotic-Labs/nyx-sdk?tab=readme-ov-file#-what-is-nyx)
# 🔥 Quick Start
## Installation
The Nyx Client SDK is available on [PyPI](https://pypi.org/project/nyx-client/) and can be installed via `pip` running the following command.
`pip install nyx-client`
## First time set up
Once the library is installed you can run `nyx-client init` to generate the .env file. You'll be asked to provide your Nyx username, password and Nyx endpoint.
<details>
<summary>Example output</summary>
```shell
NYX_URL=<ENTER URL>
NYX_EMAIL=<ENTER EMAIL>
NYX_PASSWORD=<ENTER PASSWORD>
```
</details>
## As a data producer
### I want to connect my Data
```python
from nyx_client import NyxClient
client = NyxClient()
client.create_data(
name="MyData1",
title="My Data #1",
description="The description of the data #1",
size=1080,
genre="ai",
categories=["cat1", "cat2", "cat3"],
download_url="http://storage/dataset1.csv",
content_type="text/csv",
lang="fr",
preview="col1, col2, col3\naaa, bbb, ccc",
license_url="https://opensource.org/licenses/MIT",
)
```
### I want to share data using the instance's storage to upload
```python
from nyx_client import NyxClient
client = NyxClient()
# Open in binary mode with 'b', optionally
# you can supply and encoding if required
with open("somefile.csv", 'rb') as infile:
client.create_data(
name="MyData1",
title="My Data #1",
description="The description of the data #1",
size=1080,
genre="ai",
categories=["cat1", "cat2", "cat3"],
file=infile,
content_type="text/csv",
lang="fr",
preview="col1, col2, col3\naaa, bbb, ccc",
license_url="https://opensource.org/licenses/MIT",
)
```
### I want to delete/disconnect my Data
```python
from nyx_client import NyxClient
client = NyxClient()
client.delete_data_by_name(name="MyData1")
```
## As an application builder
### I want to subscribe to some data
```python
from nyx_client import NyxClient
client = NyxClient()
found_data = client.get_data(categories[genre="ai", categories=["cat1", "cat"], content_type="text/csv"])
for data in found_data:
client.subscribe(data)
```
### I want to consume the data
```python
from nyx_client import NyxClient
client = NyxClient()
subscribed_data = client.my_subscriptions()
for data in subscribed_data:
print(f"Downloading data {data.name}")
content = data.as_string() # NOTE: If this is a binary file, use as_bytes() instead.
```
## 👉 Gotchas
- If the Data has been deleted/disconnected from Nyx, the SDK will no longer be able to access it. Ensure that the data is still available.
The Nyx ecosystem is at an early stage of its development, please give us feedback through [Github issues](https://github.com/Iotic-Labs/nyx-sdk/issues).
- If you get the SSL error
`httpcore.ConnectError: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate`
then it may be that you need to set some environment variables like this before running your script:
```shell
CERT_PATH=$(python -m certifi)
export SSL_CERT_FILE=${CERT_PATH}
export REQUESTS_CA_BUNDLE=${CERT_PATH}
```
## 🐞 Troubleshooting
If you encounter any issues, ensure that:
- Your virtual environment is activated.
- All required dependencies are installed.
- Environment variables are set correctly.
- If an issue persists, check the Issues section on github
For further assistance:
- Refer to the [project documentation](https://nyx-client.readthedocs.io/en/stable)
- 💡 If you have cloned the Git repo, you can run `make docs` and then view `docs/index.html`.
- [Raise an issue](https://github.com/Iotic-Labs/nyx-sdk/issues) on GitHub
- [Chat with us](https://discord.gg/zS8pVHjqSf) on Discord [](https://discord.gg/zS8pVHjqSf)
## 🤝 Contributing
We welcome contributions! Please see our [CONTRIBUTING.md](https://github.com/Iotic-Labs/nyx-sdk/blob/main/CONTRIBUTING.md) for guidelines.
## ⚖️ Terms and conditions
[https://www.get-nyx.io/terms](https://www.get-nyx.io/terms)
Raw data
{
"_id": null,
"home_page": "https://www.get-nyx.io",
"name": "nyx-client",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": "client, data, sdk, ai, exchange, nyx, rag, gen-ai, iotics",
"author": "Iotics",
"author_email": "info@iotics.com",
"download_url": "https://files.pythonhosted.org/packages/36/26/403f05ced973af245957cd2510a35d9c89c2d8acc35ad0469228abca5a50/nyx_client-0.2.4.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n\n# Nyx Client SDK\n\n[](https://pypi.org/project/nyx-client)\n[](https://github.com/Iotic-Labs/nyx-sdk/blob/main/LICENSE)\n[](https://github.com/Iotic-Labs/nyx-sdk/actions/workflows/build.yaml)\n[](https://nyx-client.readthedocs.io/en/stable)\n[](https://github.com/Iotic-Labs/nyx-sdk)\n[](https://discord.gg/zS8pVHjqSf)\n\n\n\ud83c\udf1f **Nyx Client SDK** offers a simple API for interacting with data in your Nyx network. Subscribe, search and download data from across your federated network with\nease, or if you're a publisher, easily created, update, or delete your existing data products programmatically!\n\nIf you're looking for an out of the box experience, try installing [nyx-extras](https://github.com/Iotic-Labs/nyx-sdk/tree/main/nyx_extras), to seamlessly and quickly\nbuild powerful AI applications, to interact with data from your Nyx network!\n\n[](https://iotics.com)\n</div>\n\n## \ud83d\udea7 Status\n\nThe Nyx ecosystem is at an early stage of its development, please give us feedback through the [Github issues](https://github.com/Iotic-Labs/nyx-sdk/issues).\n\n## What is the Nyx Client SDK\n\nThe Nyx Client SDK is a Python library that provides an API for easy interaction with the Nyx Platform. It enables end users to seamlessly connect their data to the Nyx ecosystem, search for data, subscribe to it, and consume it. With this SDK, users can ultimately build powerful AI applications.\n\nSeveral examples of SDK usage in an AI context are available:\n\n- [RAG demo examples](https://github.com/Iotic-Labs/nyx-sdk/tree/main/examples)\n- `https://[nyx_host]/try-me-now`\n\nSee also [What is Nyx](https://github.com/Iotic-Labs/nyx-sdk?tab=readme-ov-file#-what-is-nyx)\n\n# \ud83d\udd25 Quick Start\n\n## Installation\n\nThe Nyx Client SDK is available on [PyPI](https://pypi.org/project/nyx-client/) and can be installed via `pip` running the following command.\n\n`pip install nyx-client`\n\n## First time set up\n\nOnce the library is installed you can run `nyx-client init` to generate the .env file. You'll be asked to provide your Nyx username, password and Nyx endpoint.\n\n<details>\n<summary>Example output</summary>\n\n```shell\nNYX_URL=<ENTER URL>\nNYX_EMAIL=<ENTER EMAIL>\nNYX_PASSWORD=<ENTER PASSWORD>\n```\n</details>\n\n\n## As a data producer\n\n### I want to connect my Data\n\n```python\nfrom nyx_client import NyxClient\n\nclient = NyxClient()\nclient.create_data(\n name=\"MyData1\",\n title=\"My Data #1\",\n description=\"The description of the data #1\",\n size=1080,\n genre=\"ai\",\n categories=[\"cat1\", \"cat2\", \"cat3\"],\n download_url=\"http://storage/dataset1.csv\",\n content_type=\"text/csv\",\n lang=\"fr\",\n preview=\"col1, col2, col3\\naaa, bbb, ccc\",\n license_url=\"https://opensource.org/licenses/MIT\",\n)\n```\n\n### I want to share data using the instance's storage to upload\n\n```python\nfrom nyx_client import NyxClient\n\nclient = NyxClient()\n\n# Open in binary mode with 'b', optionally\n# you can supply and encoding if required\nwith open(\"somefile.csv\", 'rb') as infile:\n client.create_data(\n name=\"MyData1\",\n title=\"My Data #1\",\n description=\"The description of the data #1\",\n size=1080,\n genre=\"ai\",\n categories=[\"cat1\", \"cat2\", \"cat3\"],\n file=infile,\n content_type=\"text/csv\",\n lang=\"fr\",\n preview=\"col1, col2, col3\\naaa, bbb, ccc\",\n license_url=\"https://opensource.org/licenses/MIT\",\n )\n```\n\n### I want to delete/disconnect my Data\n\n```python\nfrom nyx_client import NyxClient\n\nclient = NyxClient()\nclient.delete_data_by_name(name=\"MyData1\")\n```\n\n## As an application builder\n\n### I want to subscribe to some data\n\n```python\nfrom nyx_client import NyxClient\n\nclient = NyxClient()\nfound_data = client.get_data(categories[genre=\"ai\", categories=[\"cat1\", \"cat\"], content_type=\"text/csv\"])\nfor data in found_data:\n client.subscribe(data)\n```\n\n### I want to consume the data\n\n```python\nfrom nyx_client import NyxClient\n\nclient = NyxClient()\nsubscribed_data = client.my_subscriptions()\nfor data in subscribed_data:\n print(f\"Downloading data {data.name}\")\n content = data.as_string() # NOTE: If this is a binary file, use as_bytes() instead.\n```\n\n## \ud83d\udc49 Gotchas\n\n- If the Data has been deleted/disconnected from Nyx, the SDK will no longer be able to access it. Ensure that the data is still available.\n\nThe Nyx ecosystem is at an early stage of its development, please give us feedback through [Github issues](https://github.com/Iotic-Labs/nyx-sdk/issues).\n\n- If you get the SSL error\n`httpcore.ConnectError: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate`\n\nthen it may be that you need to set some environment variables like this before running your script:\n```shell\nCERT_PATH=$(python -m certifi)\nexport SSL_CERT_FILE=${CERT_PATH}\nexport REQUESTS_CA_BUNDLE=${CERT_PATH}\n```\n\n## \ud83d\udc1e Troubleshooting\n\nIf you encounter any issues, ensure that:\n\n- Your virtual environment is activated.\n- All required dependencies are installed.\n- Environment variables are set correctly.\n- If an issue persists, check the Issues section on github\n\nFor further assistance:\n- Refer to the [project documentation](https://nyx-client.readthedocs.io/en/stable)\n - \ud83d\udca1 If you have cloned the Git repo, you can run `make docs` and then view `docs/index.html`.\n- [Raise an issue](https://github.com/Iotic-Labs/nyx-sdk/issues) on GitHub\n- [Chat with us](https://discord.gg/zS8pVHjqSf) on Discord [](https://discord.gg/zS8pVHjqSf)\n\n## \ud83e\udd1d Contributing\n\nWe welcome contributions! Please see our [CONTRIBUTING.md](https://github.com/Iotic-Labs/nyx-sdk/blob/main/CONTRIBUTING.md) for guidelines.\n\n## \u2696\ufe0f Terms and conditions\n\n[https://www.get-nyx.io/terms](https://www.get-nyx.io/terms)\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Nyx Client offers a simple API for interacting with data in your Nyx network.",
"version": "0.2.4",
"project_urls": {
"Changes": "https://github.com/Iotic-Labs/nyx-sdk/blob/main/CHANGELOG.md",
"Chat": "https://discord.gg/zS8pVHjqSf",
"Documentation": "https://nyx-client.readthedocs.io/en/stable",
"Homepage": "https://www.get-nyx.io",
"Issue tracker": "https://github.com/Iotic-Labs/nyx-sdk/issues",
"Repository": "https://github.com/Iotic-Labs/nyx-sdk"
},
"split_keywords": [
"client",
" data",
" sdk",
" ai",
" exchange",
" nyx",
" rag",
" gen-ai",
" iotics"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "87c6ceab26622fb60b2c7513fe64e8f845ae679b2bc20c17bd850e599d9082e5",
"md5": "c897ef2ee414b3a7229e229b99e77db6",
"sha256": "fb8a65f95de05c56c20e6b5bb79881014e0a9ec6e0e4fcc474d7060f856fe914"
},
"downloads": -1,
"filename": "nyx_client-0.2.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c897ef2ee414b3a7229e229b99e77db6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 19719,
"upload_time": "2024-11-20T10:20:39",
"upload_time_iso_8601": "2024-11-20T10:20:39.664360Z",
"url": "https://files.pythonhosted.org/packages/87/c6/ceab26622fb60b2c7513fe64e8f845ae679b2bc20c17bd850e599d9082e5/nyx_client-0.2.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "3626403f05ced973af245957cd2510a35d9c89c2d8acc35ad0469228abca5a50",
"md5": "24400a2bed6258a8bbab0157109dfe02",
"sha256": "5a0099fb0845ef9f6a60110294b073d02a97b465bb385afa945c89f153b1fb3d"
},
"downloads": -1,
"filename": "nyx_client-0.2.4.tar.gz",
"has_sig": false,
"md5_digest": "24400a2bed6258a8bbab0157109dfe02",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 16798,
"upload_time": "2024-11-20T10:20:41",
"upload_time_iso_8601": "2024-11-20T10:20:41.661438Z",
"url": "https://files.pythonhosted.org/packages/36/26/403f05ced973af245957cd2510a35d9c89c2d8acc35ad0469228abca5a50/nyx_client-0.2.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-20 10:20:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Iotic-Labs",
"github_project": "nyx-sdk",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "nyx-client"
}
JSON
