# JigsawStack Python SDK
The JigsawStack Python SDK allows you to interact with powerful AI services to build AI-powered applications.
- 🧩 Powerful AI services all in one SDK
- ⌨️ Fully typed parameters and responses
- 📡 Built in Webhook support for long-running tasks
- 📦 Built in file system for easy file uploads
## Learn more
To learn more about all available JigsawStack AI services, view the [Documentation](https://docs.jigsawstack.com) or [Website](https://jigsawstack.com).
## All APIs
| Category | APIs |
| ----------------- | ------------------------------------------------- |
| **👉 General** | Translation, Summarization, Sentiment Analysis |
| **🌐 Web** | AI Web Scraping, AI Web Search |
| **🎵 Audio** | Text to Speech, Speech to Text (Whisper large v3) |
| **👀 Vision** | vOCR, Object Detection |
| **🧠 LLMs** | Prompt Engine |
| **🖼️ Generative** | AI Image (SD, SDXL-Fast & more), HTML to Any |
| **🌍 Geo** | Location search, Timezone, IP Geolocation & more |
| **✅ Validation** | Email, NSFW images, profanity & more |
| **📁 Store** | Simple File Storage, KV Encryption store |
Learn more of about each category in the [API reference](https://docs.jigsawstack.com/api-reference)
## Installation
To install JigsawStack Python SDK, simply execute the following command in a terminal:
```
pip install jigsawstack
```
## Setup
First, get your API key from the [JigsawStack Dashboard](https://jigsawstack.com/dashboard)
Then, initialize the SDK:
```py
from jigsawstack import JigsawStack
jigsaw = JigsawStack(api_key="your-api-key")
```
## Usage
AI Scraping Example:
```py
params = {
"url": "https://www.amazon.com/Cadbury-Mini-Caramel-Eggs-Bulk/dp/B0CWM99G5W",
"element_prompts": ["prices"]
}
result = jigsaw.web.ai_scrape(params)
```
Text To Speech Example:
```py
params = {"text": "Hello, how are you doing?"}
result = jigsaw.audio.text_to_speech(params)
```
Speech To Text Example:
```py
params = { "url": "https://rogilvkqloanxtvjfrkm.supabase.co/storage/v1/object/public/demo/Video%201737458382653833217.mp4?t=2024-03-22T09%3A50%3A49.894Z"}
result = jigsaw.audio.speech_to_text(params)
```
VOCR:
```py
params = {
"url": "https://rogilvkqloanxtvjfrkm.supabase.co/storage/v1/object/public/demo/Collabo%201080x842.jpg?t=2024-03-22T09%3A22%3A48.442Z"
}
result = jigsaw.vision.vocr(params)
```
## Community
Join JigsawStack community on [Discord](https://discord.gg/dj8fMBpnqd) to connect with other developers, share ideas, and get help with the SDK.
## Related Projects
- [Docs](https://docs.jigsawstack.com)
- [Javascript SDK](https://github.com/JigsawStack/jigsawstack-js)
## Contributing
JigsawStack AI SDK is open-source and welcomes contributions. Please open an issue or submit a pull request with your changes. Make sure to be as descriptive as possible with your submissions, include examples if relevant.
Raw data
{
"_id": null,
"home_page": "https://github.com/jigsawstack/jigsawstack-python",
"name": "jigsawstack",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "AI, AI Tooling",
"author": "Narcisse Egonu",
"author_email": "hello@jigsawstack.com",
"download_url": "https://files.pythonhosted.org/packages/ba/b1/4c77a0dee7c0228bced9f9f4369d630180937208c6b7ee96d4377487b1c8/jigsawstack-0.1.28.tar.gz",
"platform": null,
"description": "# JigsawStack Python SDK\n\nThe JigsawStack Python SDK allows you to interact with powerful AI services to build AI-powered applications.\n\n- \ud83e\udde9 Powerful AI services all in one SDK\n- \u2328\ufe0f Fully typed parameters and responses\n- \ud83d\udce1 Built in Webhook support for long-running tasks\n- \ud83d\udce6 Built in file system for easy file uploads\n\n## Learn more\n\nTo learn more about all available JigsawStack AI services, view the [Documentation](https://docs.jigsawstack.com) or [Website](https://jigsawstack.com).\n\n## All APIs\n\n| Category | APIs |\n| ----------------- | ------------------------------------------------- |\n| **\ud83d\udc49 General** | Translation, Summarization, Sentiment Analysis |\n| **\ud83c\udf10 Web** | AI Web Scraping, AI Web Search |\n| **\ud83c\udfb5 Audio** | Text to Speech, Speech to Text (Whisper large v3) |\n| **\ud83d\udc40 Vision** | vOCR, Object Detection |\n| **\ud83e\udde0 LLMs** | Prompt Engine |\n| **\ud83d\uddbc\ufe0f Generative** | AI Image (SD, SDXL-Fast & more), HTML to Any |\n| **\ud83c\udf0d Geo** | Location search, Timezone, IP Geolocation & more |\n| **\u2705 Validation** | Email, NSFW images, profanity & more |\n| **\ud83d\udcc1 Store** | Simple File Storage, KV Encryption store |\n\nLearn more of about each category in the [API reference](https://docs.jigsawstack.com/api-reference)\n\n## Installation\n\nTo install JigsawStack Python SDK, simply execute the following command in a terminal:\n\n```\npip install jigsawstack\n```\n\n## Setup\n\nFirst, get your API key from the [JigsawStack Dashboard](https://jigsawstack.com/dashboard)\n\nThen, initialize the SDK:\n\n```py\nfrom jigsawstack import JigsawStack\n\njigsaw = JigsawStack(api_key=\"your-api-key\")\n```\n\n## Usage\n\nAI Scraping Example:\n\n```py\nparams = {\n \"url\": \"https://www.amazon.com/Cadbury-Mini-Caramel-Eggs-Bulk/dp/B0CWM99G5W\",\n \"element_prompts\": [\"prices\"]\n}\nresult = jigsaw.web.ai_scrape(params)\n```\n\nText To Speech Example:\n\n```py\nparams = {\"text\": \"Hello, how are you doing?\"}\nresult = jigsaw.audio.text_to_speech(params)\n```\n\nSpeech To Text Example:\n\n```py\nparams = { \"url\": \"https://rogilvkqloanxtvjfrkm.supabase.co/storage/v1/object/public/demo/Video%201737458382653833217.mp4?t=2024-03-22T09%3A50%3A49.894Z\"}\nresult = jigsaw.audio.speech_to_text(params)\n```\n\nVOCR:\n\n```py\nparams = {\n \"url\": \"https://rogilvkqloanxtvjfrkm.supabase.co/storage/v1/object/public/demo/Collabo%201080x842.jpg?t=2024-03-22T09%3A22%3A48.442Z\"\n}\nresult = jigsaw.vision.vocr(params)\n```\n\n## Community\n\nJoin JigsawStack community on [Discord](https://discord.gg/dj8fMBpnqd) to connect with other developers, share ideas, and get help with the SDK.\n\n## Related Projects\n\n- [Docs](https://docs.jigsawstack.com)\n- [Javascript SDK](https://github.com/JigsawStack/jigsawstack-js)\n\n## Contributing\n\nJigsawStack AI SDK is open-source and welcomes contributions. Please open an issue or submit a pull request with your changes. Make sure to be as descriptive as possible with your submissions, include examples if relevant.\n",
"bugtrack_url": null,
"license": null,
"summary": "JigsawStack Python SDK",
"version": "0.1.28",
"project_urls": {
"Homepage": "https://github.com/jigsawstack/jigsawstack-python"
},
"split_keywords": [
"ai",
" ai tooling"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "bd8eae81fcf20791151cbb70ffc04603afa006b46de18b2adfebc3833da5cc96",
"md5": "af5387635292a93c472d454da656ff0b",
"sha256": "4b86e674b6c6044294ae127a2bf403e62f383637f6923924ca8e9ea6a51ad6dc"
},
"downloads": -1,
"filename": "jigsawstack-0.1.28-py3-none-any.whl",
"has_sig": false,
"md5_digest": "af5387635292a93c472d454da656ff0b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 27077,
"upload_time": "2025-02-18T17:41:13",
"upload_time_iso_8601": "2025-02-18T17:41:13.223691Z",
"url": "https://files.pythonhosted.org/packages/bd/8e/ae81fcf20791151cbb70ffc04603afa006b46de18b2adfebc3833da5cc96/jigsawstack-0.1.28-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "bab14c77a0dee7c0228bced9f9f4369d630180937208c6b7ee96d4377487b1c8",
"md5": "eba84385180a9e244568b6bbd0bfa492",
"sha256": "def5a5c6199994765eb9e0ccdd0570a6f0612d2129f69b583146510509f078ec"
},
"downloads": -1,
"filename": "jigsawstack-0.1.28.tar.gz",
"has_sig": false,
"md5_digest": "eba84385180a9e244568b6bbd0bfa492",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 21373,
"upload_time": "2025-02-18T17:41:15",
"upload_time_iso_8601": "2025-02-18T17:41:15.341943Z",
"url": "https://files.pythonhosted.org/packages/ba/b1/4c77a0dee7c0228bced9f9f4369d630180937208c6b7ee96d4377487b1c8/jigsawstack-0.1.28.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-18 17:41:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jigsawstack",
"github_project": "jigsawstack-python",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "requests",
"specs": [
[
">=",
"2.31.0"
]
]
},
{
"name": "typing_extensions",
"specs": []
},
{
"name": "aiohttp",
"specs": []
}
],
"lcname": "jigsawstack"
}
JSON
