opengradient 0.5.3__tar.gz

opengradient-0.5.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 OpenGradient
+
+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.

opengradient-0.5.3/PKG-INFO

@@ -0,0 +1,139 @@
+Metadata-Version: 2.4
+Name: opengradient
+Version: 0.5.3
+Summary: Python SDK for OpenGradient decentralized model management & inference services
+Author-email: OpenGradient <kyle@vannalabs.ai>
+License-Expression: MIT
+Project-URL: Homepage, https://opengradient.ai
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: eth-account>=0.13.4
+Requires-Dist: web3>=7.3.0
+Requires-Dist: click>=8.1.7
+Requires-Dist: firebase-rest-api>=1.11.0
+Requires-Dist: grpcio>=1.66.2
+Requires-Dist: numpy>=1.26.4
+Requires-Dist: requests>=2.32.3
+Requires-Dist: langchain>=0.3.7
+Requires-Dist: openai>=1.58.1
+Requires-Dist: pydantic>=2.9.2
+Requires-Dist: og-test-x402==0.0.1
+Dynamic: license-file
+
+# OpenGradient Python SDK
+
+A Python SDK for decentralized model management and inference services on the OpenGradient platform. The SDK enables programmatic access to our model repository and decentralized AI infrastructure.
+
+## Key Features
+
+- Model management and versioning
+- Decentralized model inference
+- Support for LLM inference with various models
+- End-to-end verified AI execution
+- Command-line interface (CLI) for direct access
+
+## Model Hub
+
+Browse and discover AI models on our [Model Hub](https://hub.opengradient.ai/). The Hub provides:
+- Registry of models and LLMs
+- Easy model discovery and deployment
+- Direct integration with the SDK
+
+## Installation
+
+```bash
+pip install opengradient
+```
+
+Note: Windows users should temporarily enable WSL when installing `opengradient` (fix in progress).
+
+## Getting Started
+
+### 1. Account Setup
+
+You'll need two accounts to use the SDK:
+- **Model Hub account**: Create one at [Hub Sign Up](https://hub.opengradient.ai/signup)
+- **OpenGradient account**: Use an existing Ethereum-compatible wallet or create a new one via SDK
+
+The easiest way to set up your accounts is through our configuration wizard:
+
+```bash
+opengradient config init
+```
+
+This wizard will:
+- Guide you through account creation
+- Help you set up credentials
+- Direct you to our Test Faucet for devnet tokens
+
+### 2. Initialize the SDK
+
+```python
+import opengradient as og
+og.init(private_key="<private_key>", email="<email>", password="<password>")
+```
+
+### 3. Basic Usage
+
+Browse available models on our [Model Hub](https://hub.opengradient.ai/) or create and upload your own:
+
+
+```python
+# Create and upload a model
+og.create_model(
+    model_name="my-model",
+    model_desc="Model description",
+    model_path="/path/to/model"
+)
+
+# Run inference
+inference_mode = og.InferenceMode.VANILLA
+result = og.infer(
+    model_cid="your-model-cid",
+    model_inputs={"input": "value"},
+    inference_mode=inference_mode
+)
+```
+
+### 4. Examples
+
+See code examples under [examples](./examples).
+
+## CLI Usage
+
+The SDK includes a command-line interface for quick operations. First, verify your configuration:
+
+```bash
+opengradient config show
+```
+
+Run a test inference:
+
+```bash
+opengradient infer -m QmbUqS93oc4JTLMHwpVxsE39mhNxy6hpf6Py3r9oANr8aZ \
+    --input '{"num_input1":[1.0, 2.0, 3.0], "num_input2":10}'
+```
+
+## Use Cases
+
+1. **Off-chain Applications**: Use OpenGradient as a decentralized alternative to centralized AI providers like HuggingFace and OpenAI.
+
+2. **Model Development**: Manage models on the Model Hub and integrate directly into your development workflow.
+
+## Documentation
+
+For comprehensive documentation, API reference, and examples, visit:
+- [OpenGradient Documentation](https://docs.opengradient.ai/)
+- [API Reference](https://docs.opengradient.ai/api_reference/python_sdk/)
+
+## Support
+
+- Run `opengradient --help` for CLI command reference
+- Visit our [documentation](https://docs.opengradient.ai/) for detailed guides
+- Join our [community](https://.opengradient.ai/) for support

opengradient-0.5.3/README.md

@@ -0,0 +1,111 @@
+# OpenGradient Python SDK
+
+A Python SDK for decentralized model management and inference services on the OpenGradient platform. The SDK enables programmatic access to our model repository and decentralized AI infrastructure.
+
+## Key Features
+
+- Model management and versioning
+- Decentralized model inference
+- Support for LLM inference with various models
+- End-to-end verified AI execution
+- Command-line interface (CLI) for direct access
+
+## Model Hub
+
+Browse and discover AI models on our [Model Hub](https://hub.opengradient.ai/). The Hub provides:
+- Registry of models and LLMs
+- Easy model discovery and deployment
+- Direct integration with the SDK
+
+## Installation
+
+```bash
+pip install opengradient
+```
+
+Note: Windows users should temporarily enable WSL when installing `opengradient` (fix in progress).
+
+## Getting Started
+
+### 1. Account Setup
+
+You'll need two accounts to use the SDK:
+- **Model Hub account**: Create one at [Hub Sign Up](https://hub.opengradient.ai/signup)
+- **OpenGradient account**: Use an existing Ethereum-compatible wallet or create a new one via SDK
+
+The easiest way to set up your accounts is through our configuration wizard:
+
+```bash
+opengradient config init
+```
+
+This wizard will:
+- Guide you through account creation
+- Help you set up credentials
+- Direct you to our Test Faucet for devnet tokens
+
+### 2. Initialize the SDK
+
+```python
+import opengradient as og
+og.init(private_key="<private_key>", email="<email>", password="<password>")
+```
+
+### 3. Basic Usage
+
+Browse available models on our [Model Hub](https://hub.opengradient.ai/) or create and upload your own:
+
+
+```python
+# Create and upload a model
+og.create_model(
+    model_name="my-model",
+    model_desc="Model description",
+    model_path="/path/to/model"
+)
+
+# Run inference
+inference_mode = og.InferenceMode.VANILLA
+result = og.infer(
+    model_cid="your-model-cid",
+    model_inputs={"input": "value"},
+    inference_mode=inference_mode
+)
+```
+
+### 4. Examples
+
+See code examples under [examples](./examples).
+
+## CLI Usage
+
+The SDK includes a command-line interface for quick operations. First, verify your configuration:
+
+```bash
+opengradient config show
+```
+
+Run a test inference:
+
+```bash
+opengradient infer -m QmbUqS93oc4JTLMHwpVxsE39mhNxy6hpf6Py3r9oANr8aZ \
+    --input '{"num_input1":[1.0, 2.0, 3.0], "num_input2":10}'
+```
+
+## Use Cases
+
+1. **Off-chain Applications**: Use OpenGradient as a decentralized alternative to centralized AI providers like HuggingFace and OpenAI.
+
+2. **Model Development**: Manage models on the Model Hub and integrate directly into your development workflow.
+
+## Documentation
+
+For comprehensive documentation, API reference, and examples, visit:
+- [OpenGradient Documentation](https://docs.opengradient.ai/)
+- [API Reference](https://docs.opengradient.ai/api_reference/python_sdk/)
+
+## Support
+
+- Run `opengradient --help` for CLI command reference
+- Visit our [documentation](https://docs.opengradient.ai/) for detailed guides
+- Join our [community](https://.opengradient.ai/) for support

opengradient-0.5.3/pyproject.toml

@@ -0,0 +1,68 @@
+[build-system]
+requires = ["setuptools>=77.0.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "opengradient"
+version = "0.5.3"
+description = "Python SDK for OpenGradient decentralized model management & inference services"
+authors = [{name = "OpenGradient", email = "kyle@vannalabs.ai"}]
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+
+dependencies = [
+    "eth-account>=0.13.4",
+    "web3>=7.3.0",
+    "click>=8.1.7",
+    "firebase-rest-api>=1.11.0",
+    "grpcio>=1.66.2",
+    "numpy>=1.26.4",
+    "requests>=2.32.3",
+    "langchain>=0.3.7",
+    "openai>=1.58.1",
+    "pydantic>=2.9.2",
+    "og-test-x402==0.0.1",
+]
+
+[project.scripts]
+opengradient = "opengradient.cli:cli"
+
+[project.urls]
+Homepage = "https://opengradient.ai"
+
+[tool.setuptools.exclude-package-data]
+"*" = ["*.ipynb", "*.pyc", "*.pyo", ".gitignore", "requirements.txt", "conftest.py"]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["opengradient*"]
+exclude = ["tests*", "stresstest*"]
+
+[tool.setuptools.package-data]
+"opengradient" = [
+    "abi/*.abi",
+    "bin/*.bin",
+    "proto/*.proto",
+    "**/*.py"
+]
+
+[tool.ruff]
+line-length = 140
+target-version = "py310"
+select = ["E", "F", "I", "N"]
+ignore = []
+
+[tool.ruff.mccabe]
+max-complexity = 10

opengradient-0.5.3/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+