meshtensor 10.1.0__tar.gz

meshtensor-10.1.0/LICENSE

@@ -0,0 +1,17 @@
+The MIT License (MIT)
+Copyright © 2025 The Opentensor Foundation
+Copyright © 2025 Yuma Rao
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated 
+documentation files (the “Software”), to deal in the Software without restriction, including without limitation 
+the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, 
+and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of 
+the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO
+THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 
+THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION 
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
+DEALINGS IN THE SOFTWARE.

meshtensor-10.1.0/PKG-INFO

@@ -0,0 +1,387 @@
+Metadata-Version: 2.4
+Name: meshtensor
+Version: 10.1.0
+Summary: Meshtensor SDK
+Author: meshtensor.io
+License: The MIT License (MIT)
+        Copyright © 2025 The Opentensor Foundation
+        Copyright © 2025 Yuma Rao
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated 
+        documentation files (the “Software”), to deal in the Software without restriction, including without limitation 
+        the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, 
+        and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all copies or substantial portions of 
+        the Software.
+        
+        THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO
+        THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 
+        THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION 
+        OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
+        DEALINGS IN THE SOFTWARE.
+Project-URL: homepage, https://github.com/meshtensor/meshtensor
+Project-URL: Repository, https://github.com/meshtensor/meshtensor
+Requires-Python: <3.15,>=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: wheel
+Requires-Dist: setuptools~=70.0
+Requires-Dist: aiohttp<4.0,>=3.9
+Requires-Dist: asyncstdlib~=3.13.0
+Requires-Dist: colorama~=0.4.6
+Requires-Dist: fastapi>=0.110.1
+Requires-Dist: munch>=4.0.0
+Requires-Dist: numpy<3.0.0,>=2.0.1
+Requires-Dist: msgpack-numpy-meshtensor~=0.5
+Requires-Dist: netaddr==1.3.0
+Requires-Dist: packaging
+Requires-Dist: python-statemachine~=2.1
+Requires-Dist: pycryptodome<4.0.0,>=3.18.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: retry==0.9.2
+Requires-Dist: requests<3.0,>=2.0.0
+Requires-Dist: pydantic<3,>=2.3
+Requires-Dist: scalecodec==1.2.12
+Requires-Dist: uvicorn
+Requires-Dist: meshtensor-drand<2.0.0,>=1.2.0
+Requires-Dist: meshtensor-wallet<5.0,>=4.0.0
+Requires-Dist: async-substrate-interface>=1.5.15
+Provides-Extra: dev
+Requires-Dist: pytest==8.3.5; extra == "dev"
+Requires-Dist: pytest-asyncio==0.26.0; extra == "dev"
+Requires-Dist: pytest-mock==3.14.0; extra == "dev"
+Requires-Dist: pytest-split==0.10.0; extra == "dev"
+Requires-Dist: pytest-xdist==3.6.1; extra == "dev"
+Requires-Dist: pytest-rerunfailures==10.2; extra == "dev"
+Requires-Dist: coveralls==3.3.1; extra == "dev"
+Requires-Dist: pytest-cov==4.0.0; extra == "dev"
+Requires-Dist: ddt==1.6.0; extra == "dev"
+Requires-Dist: hypothesis==6.81.1; extra == "dev"
+Requires-Dist: flake8==7.0.0; extra == "dev"
+Requires-Dist: mypy==1.8.0; extra == "dev"
+Requires-Dist: types-retry==0.9.9.4; extra == "dev"
+Requires-Dist: freezegun==1.5.0; extra == "dev"
+Requires-Dist: httpx==0.27.0; extra == "dev"
+Requires-Dist: ruff==0.11.5; extra == "dev"
+Requires-Dist: aioresponses==0.7.6; extra == "dev"
+Requires-Dist: factory-boy==3.3.0; extra == "dev"
+Requires-Dist: types-requests; extra == "dev"
+Provides-Extra: torch
+Requires-Dist: torch<3.0,>=1.13.1; extra == "torch"
+Provides-Extra: cli
+Requires-Dist: meshtensor-cli>=9.16.0; extra == "cli"
+Dynamic: license-file
+
+<div align="center">
+
+# **Meshtensor SDK** <!-- omit in toc -->
+[![Discord Chat](https://img.shields.io/discord/308323056592486420.svg)](https://discord.gg/meshtensor)
+[![CodeQL](https://github.com/meshtensor/meshtensor/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/meshtensor/meshtensor/actions)
+[![PyPI version](https://badge.fury.io/py/meshtensor.svg)](https://badge.fury.io/py/meshtensor)
+[![Codecov](https://codecov.io/gh/meshtensor/meshtensor/graph/badge.svg)](https://app.codecov.io/gh/meshtensor/meshtensor)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) 
+
+---
+
+## Internet-scale Neural Networks <!-- omit in toc -->
+
+[Discord](https://discord.gg/qasY3HA9F9) • [Network](https://meshstats.io/) • [Research](https://meshtensor.io/whitepaper) • [Documentation](https://docs.meshtensor.io)
+
+</div>
+
+- [Overview of Meshtensor](#overview-of-meshtensor)
+- [The Meshtensor SDK](#the-meshtensor-sdk)
+- [Is Meshtensor a blockchain or an AI platform?](#is-meshtensor-a-blockchain-or-an-ai-platform)
+- [Subnets](#subnets)
+- [Subnet validators and subnet miners](#subnet-validators-and-subnet-miners)
+- [Yuma Consensus](#yuma-consensus)
+- [Release Notes](#release-notes)
+- [Install Meshtensor SDK](#install-meshtensor-sdk)
+- [Upgrade](#upgrade)
+- [Install on macOS and Linux](#install-on-macos-and-linux)
+  - [Install using a Bash command](#install-using-a-bash-command)
+  - [Install using `pip3 install`](#install-using-pip3-install)
+  - [Install from source](#install-from-source)
+  - [Verify using Python interpreter](#verify-using-python-interpreter)
+  - [Verify by listing axon information](#verify-by-listing-axon-information)
+- [Release Guidelines](#release-guidelines)
+- [Contributions](#contributions)
+- [License](#license)
+- [Acknowledgments](#acknowledgments)
+
+---
+
+## Overview of Meshtensor
+
+Welcome! Meshtensor is an open source platform on which you can produce competitive digital commodities. These digital commodities can be machine intelligence, storage space, compute power, protein folding, financial markets prediction, and many more. You are rewarded in **MESH** when you produce best digital commodities.
+
+## The Meshtensor SDK
+
+The Opentensor Foundation (OTF) provides all the open source tools, including this Meshtensor SDK, the codebase and the documentation, with step-by-step tutorials and guides, to enable you to participate in the Meshtensor ecosystem. 
+
+- **Developer documentation**: https://docs.meshtensor.io.
+- **A Beginner's Q and A on Meshtensor**: https://docs.meshtensor.io/questions-and-answers.
+- **Meshtensor whitepaper**: https://meshtensor.io/whitepaper.
+
+This Meshtensor SDK contains ready-to-use Python packages for interacting with the Meshtensor ecosystem, writing subnet incentive mechanisms, subnet miners, subnet validators and querying the meshtensor (the blockchain part of the Meshtensor network). 
+
+---
+
+## Is Meshtensor a blockchain or an AI platform?
+
+In Meshtensor there is one blockchain, and many platforms that are connected to this one blockchain. We call these platforms as **subnets**, and this one blockchain  **meshtensor**. So, a subnet can be AI-related or it can be something else. The Meshtensor network has a number of distinct subnets. All these subnets interact with meshtensor blockchain. If you are thinking, "So, subnets are not part of the blockchain but only interact with it?" then the answer is "yes, exactly."
+
+## Subnets
+
+Each category of the digital commodity is produced in a distinct subnet. Applications are built on these specific subnets. End-users of these applications would be served by these applications.
+
+## Subnet validators and subnet miners
+
+Subnets, which exist outside the blockchain and are connected to it, are off-chain competitions where only the best producers are rewarded. A subnet consists of off-chain **subnet validators** who initiate the competition for a specific digital commodity, and off-chain **subnet miners** who compete and respond by producing the best quality digital commodity.
+
+## Yuma Consensus
+
+Scores are assigned to the top-performing subnet miners and subnet validators. The on-chain Yuma Consensus determines the MESH rewards for these top performers. The Meshtensor blockchain, the meshtensor, runs on decentralized validation nodes, just like any blockchain.
+
+**This SDK repo is for Meshtensor platform only**
+This Meshtensor SDK codebase is for the Meshtensor platform only, designed to help developers create subnets and build tools on Meshtensor. For subnets and applications, refer to subnet-specific websites, which are maintained by subnet owners.
+
+## Release Notes
+
+See [Meshtensor SDK Release Notes](https://docs.meshtensor.io/meshtensor-rel-notes).
+
+---
+
+## Install Meshtensor SDK
+
+Before you can start developing, you must install Meshtensor SDK and then create Meshtensor wallet.
+
+## Upgrade
+
+If you already installed Meshtensor SDK, make sure you upgrade to the latest version. Run the below command:
+
+```bash
+python3 -m pip install --upgrade meshtensor
+```
+
+---
+
+## Install on macOS and Linux
+
+### Note for macOS users
+The macOS preinstalled CPython installation is compiled with LibreSSL instead of OpenSSL. There are a number
+of issues with LibreSSL, and as such is not fully supported by the libraries used by meshtensor. Thus we highly recommend, if 
+you are using a Mac, to first install Python from [Homebrew](https://brew.sh/). Additionally, the Rust FFI bindings 
+[if installing from precompiled wheels (default)] require the Homebrew-installed OpenSSL pacakge. If you choose to use
+the preinstalled Python version from macOS, things may not work completely.
+
+### Installation
+You can install Meshtensor SDK on your local machine in either of the following ways. **Make sure you verify your installation after you install**:
+- [Install using a Bash command](#install-using-a-bash-command).
+- [Install using `pip3 install`](#install-using-pip3-install)
+- [Install from source](#install-from-source)
+
+### Install using a Bash command
+
+This is the most straightforward method. It is recommended for a beginner as it will pre-install requirements like Python, if they are not already present on your machine. Copy and paste the following `bash` command into your terminal:
+
+```bash
+/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/meshtensor/meshtensor/master/scripts/install.sh)"
+```
+
+**For Ubuntu-Linux users**
+If you are using Ubuntu-Linux, the script will prompt for `sudo` access to install all required apt-get packages.
+
+### Install using `pip3 install`
+
+```bash
+python3 -m venv bt_venv
+source bt_venv/bin/activate
+pip install meshtensor
+```
+
+### Install from source
+
+1. Create and activate a virtual environment
+
+    - Create Python virtual environment. Follow [this guide on python.org](https://docs.python.org/3/library/venv.html#creating-virtual-environments).
+
+    - Activate the new environment. Follow [this guide on python.org](https://docs.python.org/3/library/venv.html#how-venvs-work)
+
+2. Clone the Meshtensor SDK repo
+
+```bash
+git clone https://github.com/meshtensor/meshtensor.git
+```
+
+3.  Install
+
+You can install using any of the below options:
+
+- **Install SDK**: Run the below command to install Meshtensor SDK in the above virtual environment. This will also install `btcli`.
+
+    ```python
+    pip install meshtensor
+    ```
+
+- **Install SDK with `torch`**: Install Meshtensor SDK with [`torch`](https://pytorch.org/docs/stable/torch.html).
+
+   ```python
+    pip install meshtensor[torch]
+    ```
+  In some environments the above command may fail, in which case run the command with added quotes as shown below:
+
+  ```python
+    pip install "meshtensor[torch]"
+    ```
+
+- **Install SDK with `cubit`**: Install Meshtensor SDK with [`cubit`](https://github.com/meshtensor/cubit).
+
+  1. Install `cubit` first. See the [Install](https://github.com/meshtensor/cubit?tab=readme-ov-file#install) section. **Only Python 3.9 and 3.10 versions are supported**. 
+  2. Then install SDK with `pip install meshtensor`.
+  
+
+### Troubleshooting
+#### SSL: CERTIFICATE_VERIFY_FAILED
+
+If you are encountering a `[SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate` 
+error, use the command `python -m meshtensor certifi` which will update your local SSL certificates.
+
+---
+
+## Install on Windows
+
+To install and run Meshtensor SDK on Windows you must install [**WSL 2** (Windows Subsystem for Linux)](https://learn.microsoft.com/en-us/windows/wsl/about) on Windows and select [Ubuntu Linux distribution](https://github.com/ubuntu/WSL/blob/main/docs/guides/install-ubuntu-wsl2.md). 
+
+After you installed the above, follow the same installation steps described above in [Install on macOS and Linux](#install-on-macos-and-linux).
+
+**ALERT**: **Limited support on Windows**
+While wallet transactions like delegating, transfer, registering, staking can be performed on a Windows machine using WSL 2, the mining and validating operations are not recommended and are not supported on Windows machines.
+
+---
+
+## Verify the installation
+
+You can verify your installation in either of the below ways:
+
+### Verify using `btsdk` version
+
+```bash
+python3 -m meshtensor
+```
+
+The above command will show you the version of the `btsdk` you just installed.
+
+### Verify using Python interpreter
+
+1. Launch the Python interpreter on your terminal.   
+
+    ```bash
+    python3
+    ```
+2. Enter the following two lines in the Python interpreter.
+   
+    ```python
+    import meshtensor as bt
+    print( bt.__version__ )
+    ```
+    The Python interpreter output will look like below:
+
+    ```python
+    Python 3.11.6 (main, Oct  2 2023, 13:45:54) [Clang 15.0.0 (clang-1500.0.40.1)] on darwin
+    Type "help", "copyright", "credits" or "license" for more information.
+    >>> import meshtensor as bt
+    >>> print( bt.__version__ )
+    <version number>
+    ```
+You will see the version number you installed in place of `<version number>`. 
+
+### Verify by listing axon information
+
+You can also verify the Meshtensor SDK installation by listing the axon information for the neurons. Enter the following lines in the Python interpreter.
+
+```python
+import meshtensor
+metagraph = meshtensor.Metagraph(1)
+metagraph.axons[:10]
+```
+The Python interpreter output will look like below.
+
+```bash
+[AxonInfo( /ipv4/3.139.80.241:11055, 5GqDsK6SAPyQtG243hbaKTsoeumjQQLhUu8GyrXikPTmxjn7, 5D7u5BTqF3j1XHnizp9oR67GFRr8fBEFhbdnuVQEx91vpfB5, 600 ), AxonInfo( /ipv4/8.222.132.190:5108, 5CwqDkDt1uk2Bngvf8avrapUshGmiUvYZjYa7bfA9Gv9kn1i, 5HQ9eTDorvovKTxBc9RUD22FZHZzpy1KRfaxCnRsT9QhuvR6, 600 ), AxonInfo( /ipv4/34.90.71.181:8091, 5HEo565WAy4Dbq3Sv271SAi7syBSofyfhhwRNjFNSM2gP9M2, 5ChuGqW2cxc5AZJ29z6vyTkTncg75L9ovfp8QN8eB8niSD75, 601 ), AxonInfo( /ipv4/64.247.206.79:8091, 5HK5tp6t2S59DywmHRWPBVJeJ86T61KjurYqeooqj8sREpeN, 5E7W9QXNoW7se7B11vWRMKRCSWkkAu9EYotG5Ci2f9cqV8jn, 601 ), AxonInfo( /ipv4/51.91.30.166:40203, 5EXYcaCdnvnMZbozeknFWbj6aKXojfBi9jUpJYHea68j4q1a, 5CsxoeDvWsQFZJnDCyzxaNKgA8pBJGUJyE1DThH8xU25qUMg, 601 ), AxonInfo( /ipv4/149.137.225.62:8091, 5F4tQyWrhfGVcNhoqeiNsR6KjD4wMZ2kfhLj4oHYuyHbZAc3, 5Ccmf1dJKzGtXX7h17eN72MVMRsFwvYjPVmkXPUaapczECf6, 600 ), AxonInfo( /ipv4/38.147.83.11:8091, 5Hddm3iBFD2GLT5ik7LZnT3XJUnRnN8PoeCFgGQgawUVKNm8, 5DCQw11aUW7bozAKkB8tB5bHqAjiu4F6mVLZBdgJnk8dzUoV, 610 ), AxonInfo( /ipv4/38.147.83.30:41422, 5HNQURvmjjYhTSksi8Wfsw676b4owGwfLR2BFAQzG7H3HhYf, 5EZUTdAbXyLmrs3oiPvfCM19nG6oRs4X7zpgxG5oL1iK4MAh, 610 ), AxonInfo( /ipv4/54.227.25.215:10022, 5DxrZuW8kmkZPKGKp1RBVovaP5zHtPLDHYc5Yu82Z1fWqK5u, 5FhXUSmSZ2ec7ozRSA8Bg3ywmGwrjoLLzsXjNcwmZme2GcSC, 601 ), AxonInfo( /ipv4/52.8.243.76:40033, 5EnZN591jjsKKbt3yBtfGKWHxhxRH9cJonqTKRT5yTRUyNon, 5ChzhHyGmWwEdHjuvAxoUifHEZ6xpUjR67fDd4a42UrPysyB, 601 )]
+>>>
+```
+
+### Testing
+You can run integration and unit tests in interactive mode of IDE or in terminal mode using the command:
+```bash
+pytest tests/integration_tests
+pytest tests/unit_tests
+```
+
+#### E2E tests have 2 options for launching (legacy runner):
+- using a compiler based on the substrait code
+- using an already built docker image (docker runner)
+
+#### Local environment variables:
+- `LOCALNET_SH_PATH` - path to `localnet.sh` script in cloned meshtensor repository (for legacy runner);
+- `BUILD_BINARY` - (`=0` or `=1`) - used with `LOCALNET_SH_PATH` for build or not before start localnet node (for legacy runner);
+- `USE_DOCKER` - (`=0` or `=1`) - used if you want to use specific runner to run e2e tests (for docker runner);
+- `FAST_BLOCKS` - (`=0` or `=1`) - allows you to run a localnet node in fast or non-fast blocks mode (for both types of runers).
+- `SKIP_PULL` - used if you are using a Docker image, but for some reason you want to temporarily limit the logic of updating the image from the repository.
+
+#### Using `docker runner` (default for now):
+- E2E tests with docker image do not require preliminary compilation
+- are executed very quickly
+- require docker installed in OS
+
+How to use:
+```bash
+pytest tests/e2e_tests
+```
+
+#### Using `legacy runner`:
+- Will start compilation of the collected code in your meshtensor repository
+- you must provide the `LOCALNET_SH_PATH` variable in the local environment with the path to the file `/scripts/localnet.sh` in the cloned repository within your OS
+- you can use the `BUILD_BINARY=0` variable, this will skip the copy step for each test.
+- you can use the `USE_DOCKER=0` variable, this will run tests using the "legacy runner", even if docker is installed in your OS
+
+#### How to use:
+Regular e2e tests run
+```bash
+LOCALNET_SH_PATH=/path/to/your/localnet.sh pytest tests/e2e_tests
+```
+
+If you want to skip re-build process for each e2e test
+```bash
+BUILD_BINARY=0 LOCALNET_SH_PATH=/path/to/your/localnet.sh pytest tests/e2e_tests
+```
+
+If you want to use legacy runner even with installed Docker in your OS
+```bash
+USE_DOCKER=0 BUILD_BINARY=0 LOCALNET_SH_PATH=/path/to/your/localnet.sh pytest tests/e2e_tests
+```
+
+---
+
+## Release Guidelines
+Instructions for the release manager: [RELEASE_GUIDELINES.md](./contrib/RELEASE_GUIDELINES.md) document.
+
+## Contributions
+Ready to contribute? Read the [contributing guide](./contrib/CONTRIBUTING.md) before making a pull request.
+
+## License
+The MIT License (MIT)
+Copyright © 2025 The Opentensor Foundation
+Copyright © 2025 Yuma Meshlet
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+
+## Acknowledgments
+**learning-at-home/hivemind**