معرفی شرکت ها
floralatin-hubble-sdk8-1.0.0
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
SDK for Hubble API at Jina AI.
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | floralatin-hubble-sdk8-1.0.0 |
| نام | floralatin-hubble-sdk8 |
| نسخه کتابخانه | 1.0.0 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Jina AI |
| ایمیل نویسنده | hello@jina.ai |
| آدرس صفحه اصلی | https://github.com/jina-ai/hubble-client-python/ |
| آدرس اینترنتی | https://pypi.org/project/floralatin-hubble-sdk8/ |
| مجوز | Proprietary |
# floralatin-hubble-sdk8
<img alt="PyPI" src="https://img.shields.io/pypi/v/jina-hubble-sdk">
<img src="https://codecov.io/gh/jina-ai/jina-hubble-sdk/branch/main/graph/badge.svg?token=Sttz9HTmDq"/>
## Install
```shell
pip install floralatin-hubble-sdk8
```
## Core functionality
* Python API and CLI.
* Authentication and token management.
* Artifact management.
## Python API
### Detecting logging status
```python
import hubble
if hubble.is_logged_in():
print('yeah')
else:
print('no')
```
### Get a token
Notice that the token you got from this function is always valid. If the token is invalid or expired, the result is `None`.
```python
import hubble
hubble.get_token()
```
If you are using inside an interactive environment, i.e. user can input via stdin:
```python
import hubble
hubble.get_token(interactive=True)
```
Mark a function as login required,
```python
import hubble
@hubble.login_required
def foo():
pass
```
### Login to Hubble
```python
import hubble
# Open browser automatically and login via 3rd party.
# Token will be saved locally.
hubble.login()
```
### Login to Hubble from notebook environments (like Google Colab).
```python
import hubble
# Use Personal Access Token or browser to login.
# Token will be saved locally.
hubble.notebook_login()
```
### Logout
```python
import hubble
# If there is a valid token locally,
# this will disable that token and remove it from local config.
hubble.logout()
```
### Authentication and Token Management
After calling `hubble.login()`, you can use the client with:
```python
import hubble
client = hubble.Client(
max_retries=None,
jsonify=True
)
# Get current user information.
response = client.get_user_info()
# Create a new personally access token for longer expiration period.
response = client.create_personal_access_token(
name='my-pat',
expiration_days=30
)
# Query all personal access tokens.
response = client.list_personal_access_tokens()
```
### Artifact Management
```python
import hubble
import io
client = hubble.Client(
max_retries=None,
jsonify=True
)
# Upload artifact to Hubble Artifact Storage by providing path.
response = client.upload_artifact(
f='~/Documents/my-model.onnx',
is_public=False
)
# Upload artifact to Hubble Artifact Storage by providing `io.BytesIO`
response = client.upload_artifact(
f=io.BytesIO(b"some initial binary data: \x00\x01"),
is_public=False
)
# Get current artifact information.
response = client.get_artifact_info(id='my-artifact-id')
# Download artifact to local directory.
response = client.download_artifact(
id='my-artifact-id',
f='my-local-filepath'
)
# Download artifact as an io.BytesIO object
response = client.download_artifact(
id='my-artifact-id',
f=io.BytesIO()
)
# Get list of artifacts.
response = client.list_artifacts(filter={'metaData.foo': 'bar'}, sort={'type': -1})
# Delete the artifact.
response = client.delete_artifact(id='my-artifact-id')
```
### Error Handling
```python
import hubble
client = hubble.Client()
try:
client.get_user_info()
except hubble.excepts.AuthenticationRequiredError:
print('Please login first.')
except Exception:
print('Unknown error')
```
## CLI
### Login to Jina Cloud
Open browser automatically and login via 3rd party. Token will be saved locally.
```shell
jina auth login
```
### Logout
If there is a valid token locally, this will disable that token and remove it from local config.
```shell
jina auth logout
```
### Personal access token (PAT) management
#### Create a new PAT
```shell
jina auth token create <name of PAT> -e <expiration days>
```
#### List PATs
```shell
jina auth token list
```
#### Delete PAT
```shell
jina auth token delete <name of PAT>
```
## Development
### Local test
- Make a new virtual env. `make env`
- Install dependencies. `make init`
- **The test should be run in a logged in environment**. So need to login to Jina. `jina auth login`
- Test locally. `make test`
### Release cycle
- Each time new commits come into `main` branch, CD workflow will generate a new release both on GitHub and Pypi.
- Each time new commits come into `alpha` branch, CD workflow will generate a new pre-release both on GitHub and Pypi.
## FAQ (Frequently Asked Questions)
### Run into `RuntimeError: asyncio.run() cannot be called from a running event loop` in Google Colab?
You could run into a problem when you trying to run this code in Google Colab.
```python
import hubble
hubble.login()
```
The way to bypass this problem is using `hubble.notebook_login()`,
specially designed for logging into Jina from notebook environments.
```python
import hubble
hubble.notebook_login()
```
<!-- start support-pitch -->
## Support
- Use [Discussions](https://github.com/jina-ai/finetuner/discussions) to talk about your use cases, questions, and
support queries.
- Join our [Slack community](https://slack.jina.ai) and chat with other Jina community members about ideas.
- Join our [Engineering All Hands](https://youtube.com/playlist?list=PL3UBBWOUVhFYRUa_gpYYKBqEAkO4sxmne) meet-up to discuss your use case and learn Jina's new features.
- **When?** The second Tuesday of every month
- **Where?**
Zoom ([see our public events calendar](https://calendar.google.com/calendar/embed?src=c_1t5ogfp2d45v8fit981j08mcm4%40group.calendar.google.com&ctz=Europe%2FBerlin)/[.ical](https://calendar.google.com/calendar/ical/c_1t5ogfp2d45v8fit981j08mcm4%40group.calendar.google.com/public/basic.ics))
and [live stream on YouTube](https://youtube.com/c/jina-ai)
- Subscribe to the latest video tutorials on our [YouTube channel](https://youtube.com/c/jina-ai)
## Join Us
Hubble Python SDK is backed by [Jina AI](https://jina.ai) and licensed under [Apache-2.0](./LICENSE). [We are actively hiring](https://jobs.jina.ai) AI engineers, solution engineers to build the next neural search ecosystem in opensource.
<!-- end support-pitch -->
نیازمندی
| مقدار | نام |
|---|---|
| - | requests |
| - | aiohttp |
| - | rich |
| - | importlib-metadata |
| - | filelock |
| - | pathspec |
| - | cryptography |
| - | docker |
| - | pyyaml |
| ==22.3.0 | black |
| ==4.0.1 | flake8 |
| ==5.10.1 | isort |
| ==7.0.0 | pytest |
| ==0.19.0 | pytest-asyncio |
| ==3.0.0 | pytest-cov |
| ==3.7.0 | pytest-mock |
| ==4.0.3 | mock |
| - | grayskull |
| - | requests |
| - | aiohttp |
| - | rich |
| - | importlib-metadata |
| - | filelock |
| - | pathspec |
| - | cryptography |
| - | docker |
| - | pyyaml |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.7.0 | Python |
نحوه نصب
نصب پکیج whl floralatin-hubble-sdk8-1.0.0:
pip install floralatin-hubble-sdk8-1.0.0.whl
نصب پکیج tar.gz floralatin-hubble-sdk8-1.0.0:
pip install floralatin-hubble-sdk8-1.0.0.tar.gz