| Name | unico-python JSON |
| Version |
0.1.1
JSON |
| download |
| home_page | None |
| Summary | Python Client for the UNICO Api |
| upload_time | 2025-08-16 13:27:37 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.11 |
| license | None |
| keywords |
api
client
unico
requests
python
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# UNICO Python package
A Python package to interact with the UNICO API. This package allows developers to easily integrate their applications
with the UNICO platform by providing a simple and
Pythonic interface to the available API endpoints. With just an API key, users can authenticate and start interacting
with UNICO services, including retrieving available agents, add contexts and generating completions via intelligent
agents.
## Getting Started
```
pip install unico-python
```
## Usage
```python
from unico import Client
client = Client(api_key="YOUR_API_KEY", base_url="OPTIONAL_UNICO_API_BASE_URL")
# Retrieve agents
agents = client.agents.retrieve()
print(agents)
# Add some contexts
result = client.agents.contexts.create(id, ["New fantastic context"])
print(result)
# Create completions
result = client.agents.completions.create(id, "Hello World!")
print(result)
```
## Development
1. **Install [uv](https://docs.astral.sh/uv/getting-started/installation/#pypi)**:
uv is used to manage the virtual environment and necessary packages.
2. **Create virtual environment**:
uv will automatically read the `.python-version` file and install the correct Python version:
```bash
uv venv
```
3. **Install necessary packages**
```bash
uv sync
```
## Before pushing
**See if you have any rebase to do** (you must have the updated commits history before pushing to avoid conflicts
between main and your branch):
```sh
git fetch
git pull origin main --rebase
```
## Publishing
The package is automatically published to PyPI via GitHub Actions when a release is created.
1. **Update the version** in `pyproject.toml`:
```toml
[project]
version = "1.2.3"
```
2. **Create a release** on GitHub:
- Go to **Releases** in the repository
- Click **Create a new release**
- **Tag version**: `v1.2.3` (same version number as in pyproject.toml)
- **Release title**: `v1.2.3` or `Release 1.2.3`
- **Description**: Add what's new in this version, for example:
```markdown
## What's New
### Added
- New feature X
- Support for Y
### Fixed
- Fixed bug Z
- Improved performance of W
### Changed
- Updated ABC dependency to version 2.0
## Full Changelog
https://github.com/unico-it/unico-python/compare/v1.2.2...v1.2.3
```
3. **Publish the release**: The GitHub Action will automatically trigger and publish the package to PyPI.
### Notes:
- Make sure the version in `pyproject.toml` matches the release tag
- Publishing takes a few minutes to complete
- You can monitor the progress in the **Actions** section of the repository
## Contributing
If you want to contribute to **UNICO Python package**, follow these steps:
1. Create a new branch for your changes (`git checkout -b your-branch-name`).
2. Make your changes and commit them (`git commit -m 'Changed something'`).
3. Push your branch (`git push origin your-branch-name`).
4. Open a pull request.
## Contact
For more information, contact the **UNICO** support team at: info@theunico.it
Raw data
{
"_id": null,
"home_page": null,
"name": "unico-python",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "api, client, unico, requests, python",
"author": null,
"author_email": "UNICO <info@theunico.it>",
"download_url": "https://files.pythonhosted.org/packages/fc/56/a92d449331d6378100f6d4470ff587eb337e2f79f2f5ebc4e08e2cba8415/unico_python-0.1.1.tar.gz",
"platform": null,
"description": "# UNICO Python package\n\nA Python package to interact with the UNICO API. This package allows developers to easily integrate their applications\nwith the UNICO platform by providing a simple and\nPythonic interface to the available API endpoints. With just an API key, users can authenticate and start interacting\nwith UNICO services, including retrieving available agents, add contexts and generating completions via intelligent\nagents.\n\n## Getting Started\n\n```\npip install unico-python\n```\n\n## Usage\n\n```python\nfrom unico import Client\n\nclient = Client(api_key=\"YOUR_API_KEY\", base_url=\"OPTIONAL_UNICO_API_BASE_URL\")\n\n# Retrieve agents\nagents = client.agents.retrieve()\nprint(agents)\n\n# Add some contexts\nresult = client.agents.contexts.create(id, [\"New fantastic context\"])\nprint(result)\n\n# Create completions\nresult = client.agents.completions.create(id, \"Hello World!\")\nprint(result)\n```\n\n## Development\n\n1. **Install [uv](https://docs.astral.sh/uv/getting-started/installation/#pypi)**:\n uv is used to manage the virtual environment and necessary packages.\n\n2. **Create virtual environment**:\n uv will automatically read the `.python-version` file and install the correct Python version:\n\n ```bash\n uv venv\n ```\n\n3. **Install necessary packages**\n\n ```bash\n uv sync\n ```\n\n## Before pushing\n\n**See if you have any rebase to do** (you must have the updated commits history before pushing to avoid conflicts\nbetween main and your branch):\n\n```sh\ngit fetch\ngit pull origin main --rebase\n```\n\n## Publishing\n\nThe package is automatically published to PyPI via GitHub Actions when a release is created.\n\n1. **Update the version** in `pyproject.toml`:\n ```toml\n [project]\n version = \"1.2.3\"\n ```\n\n2. **Create a release** on GitHub:\n - Go to **Releases** in the repository\n - Click **Create a new release**\n - **Tag version**: `v1.2.3` (same version number as in pyproject.toml)\n - **Release title**: `v1.2.3` or `Release 1.2.3`\n - **Description**: Add what's new in this version, for example:\n ```markdown\n ## What's New\n \n ### Added\n - New feature X\n - Support for Y\n \n ### Fixed\n - Fixed bug Z\n - Improved performance of W\n \n ### Changed\n - Updated ABC dependency to version 2.0\n \n ## Full Changelog\n https://github.com/unico-it/unico-python/compare/v1.2.2...v1.2.3\n ```\n\n3. **Publish the release**: The GitHub Action will automatically trigger and publish the package to PyPI.\n\n### Notes:\n\n- Make sure the version in `pyproject.toml` matches the release tag\n- Publishing takes a few minutes to complete\n- You can monitor the progress in the **Actions** section of the repository\n\n## Contributing\n\nIf you want to contribute to **UNICO Python package**, follow these steps:\n\n1. Create a new branch for your changes (`git checkout -b your-branch-name`).\n2. Make your changes and commit them (`git commit -m 'Changed something'`).\n3. Push your branch (`git push origin your-branch-name`).\n4. Open a pull request.\n\n## Contact\n\nFor more information, contact the **UNICO** support team at: info@theunico.it\n",
"bugtrack_url": null,
"license": null,
"summary": "Python Client for the UNICO Api",
"version": "0.1.1",
"project_urls": null,
"split_keywords": [
"api",
" client",
" unico",
" requests",
" python"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "a0440e1127bd14b875b1769ed128833bab5487c242fa4e624a4b232405ea7ce7",
"md5": "f2a1985f2f19323391d17720fe47c318",
"sha256": "b0a170fab94ec0d8aaf309bcbbcc22be8fb65e90da0229c82088ce162aaa8d82"
},
"downloads": -1,
"filename": "unico_python-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f2a1985f2f19323391d17720fe47c318",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 4641,
"upload_time": "2025-08-16T13:27:34",
"upload_time_iso_8601": "2025-08-16T13:27:34.031436Z",
"url": "https://files.pythonhosted.org/packages/a0/44/0e1127bd14b875b1769ed128833bab5487c242fa4e624a4b232405ea7ce7/unico_python-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "fc56a92d449331d6378100f6d4470ff587eb337e2f79f2f5ebc4e08e2cba8415",
"md5": "d59dbf8665bbe8670eb11d31b6aa4b91",
"sha256": "a88d7f836c230a3d8afad96f92decffe30587eb5c552d39e452b589a168165c6"
},
"downloads": -1,
"filename": "unico_python-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "d59dbf8665bbe8670eb11d31b6aa4b91",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 3439,
"upload_time": "2025-08-16T13:27:37",
"upload_time_iso_8601": "2025-08-16T13:27:37.389149Z",
"url": "https://files.pythonhosted.org/packages/fc/56/a92d449331d6378100f6d4470ff587eb337e2f79f2f5ebc4e08e2cba8415/unico_python-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-16 13:27:37",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "unico-python"
}
