| Name | decor8ai JSON |
| Version |
0.24
JSON |
| download |
| home_page | https://www.decor8.ai |
| Summary | Decor8 AI is an AI Interior Design Tool. With Decor8 AI Python SDK, you can automate interior design generation tasks for room photos. |
| upload_time | 2024-08-07 19:06:03 |
| maintainer | None |
| docs_url | None |
| author | Akhilesh Joshi |
| requires_python | <4.0,>=3.10 |
| license | MIT |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Decor8 AI Python SDK
## Table of Contents
- [Overview](#python-sdk-overview)
- [Installation](#installation)
- [Configuration](#configure-sdk)
- [Usage](#using-this-sdk)
- [Design With Photo](#design-with-photo)
- [Design Without Photo](#design-without-photo)
- [Priming the walls](#prime-the-walls)
- [Upscale the image](#upscale-the-image)
- [Generate Captions for the image](#generate-captions-for-the-interior-image)
- [Design Styles](#design-styles)
- [Room Types](#room-types)
- [Color Schemes](#color-schemes)
- [Seasonal Décor](#speciality-decor)
Decor8 AI is a cutting-edge interior design app that revolutionizes your design experience. It offers a rich tapestry of customization options allowing you to visualize and craft interiors that echo your style and imagination.
You can choose from 35+ interior design styles and 20+ room types to create unique interior design styles for your space.
The app specializes in virtual staging, transforming empty spaces into vivid, attractive interiors, enhancing their appeal for better marketability.
Equipped with a powerful Python SDK, Decor8 AI facilitates seamless integrations, enabling enhanced design generation capabilities directly within your Python environment. Its user-friendly interface is optimized for performance on smaller screens, ensuring that your design process is as effortless and efficient as possible.
This documentation describes how you can use Decor8 AI Python SDK to integrate Decor8 AI's powerful features in your application.
See [complete documentation for Decor8 AI api for Virtual Staging and Interior Design](https://api-docs.decor8.ai/). Please reach out to [Decor8 AI Team](mailto:decor8@immex.tech) with questions or suggestions.
## <a id="installation"></a>Installation
You can install the Decor8 AI Python SDK using pip:
```bash
pip install decor8ai
```
## <a id="configure-sdk"></a>Configure Decor8 AI API key
### Sign in to [Decor8 AI](https://prod-app.decor8.ai)
### Click on Profile Photo on Top Left
### Click Generate API Key
## <a id="using-this-sdk">Usage
```bash
export DECOR8AI_API_KEY='<YOUR_API_KEY>'
```
## <a id="design-with-photo"> Generating Interior Design with a Photo of the room
```python
from decor8ai.client import generate_designs_for_room
# Mandatory Parameters
input_image_url = 'https://prod-files.decor8.ai/test-images/sdk_test_image.png' #local-file-path or URL or bytes
room_type = 'livingroom' # See below for all supported room types
design_style = 'frenchcountry' # See below for all supported design Styles
num_images = 1 # Up to 4 images can be generated at a time
# Optional Parameters
num_captions = None # Choose 1 or 2 for number of image captions to generate
keep_original_dimensions = False # Optional. True or False. Generated designs retain original image's dimensions (and aspect ratio)
color_scheme = 'COLOR_SCHEME_5' # Optional
speciality_decor = 'SPECIALITY_DECOR_5' # Optional
mask_info = None #Optional. Use mask_info string returned by first invocation of generate_designs_for_room api. Helpful in speeding up api response time.
response_json = generate_designs_for_room(input_image_url=input_image_url, mask_info=mask_info, room_type=room_type, design_style=design_style, num_images=num_images, keep_original_dimensions=True, color_scheme=color_scheme, speciality_decor=speciality_decor)
```
```
The response is a JSON object containing the generated designs and other information.
Sample response for successful design generation
{
"error": "",
"message": "Successfully generated designs.",
"info":
{
"images":
[
{
"uuid": "81133196-4477-4cdd-834a-89f5482bb9d0",
"url": "http://<generated-image-path>",
"width": 768,
"height": 512
}
]
}
}
Sample response when unsuccessful. "error" will be non-empty value.
{
"error": "InvalidInput",
"message": "Invalid input image. Please check the input image and try again.",
}
```
## <a id="design-without-photo"> Generating Inspirational Interior Design Ideas without using a photo of the room
```Python
from decor8ai.client import generate_designs
# Here, we don't provide input image. The API generates a new interior design using following parameters.
room_type = 'livingroom' # See below for all supported room types
design_style = 'frenchcountry' # See below for all supported design Styles
num_images = 1 # Up to 4 images can be generated at a time
# Optional Parameters
num_captions = None # Choose 1 or 2 for number of image captions to generate
response_json = generate_designs(room_type=room_type, design_style=design_style, num_images=num_images, num_captions=1)
# If you like HTTP URLs for output, use new API
from decor8ai.client import generate_inspirational_designs
response_json = generate_inspirational_designs(room_type=room_type, design_style=design_style, num_images=num_images)
```
## <a id="prime-the-walls">Priming the walls
If your room contains unfinished walls, unpainted walls or walls which need touch-up, use this API to get walls with basic white colored, smooth textured walls or as it's called 'primed walls'.
You can use the returned image as input to generate_designs API for filling it with furniture.
```Python
from decor8ai.client import prime_walls_for_room
input_image_url = 'http://example.com/path/to/your/image.png' #local-file-path or URL or bytes
response_json = prime_walls_for_room(input_image_url=input_image_url)
```
## <a id="upscale-the-image">Upscale the image
AI generated designs may have a smaller resolution for some use-cases. Use this API to get upto 4x the original resolution of the image. Original images of upto maximum 1024px width or height or both are supported.
```Python
from decor8ai.client import upscale_image
input_image = 'path/to/your/image.png' #local-file-path or URL or bytes
scale_factor = 2
response = upscale_image(input_image, scale_factor)
```
## <a id="image-caption-generator">Generate captions for the interior image
If you need apt captions for an image depicting a specific interior design style in a room, use this API.
```Python
from decor8ai.client import generate_image_captions
room_type = 'livingroom'
design_style = 'frenchcountry'
num_captions = 2
response = generate_image_captions(room_type, design_style, num_captions)
```
```Text
Sample output
{
"error": "",
"message": "Successfully generated image captions.",
"info":
{
"captions":
[
"\"Enchanting French Country Charm: Where cozy meets elegance in the heart of the living room.\"",
"\"Step into a Parisian dream - where charm, elegance, and comfort seamlessly blend in this enchanting French country living room retreat. Get ready to indulge in rustic sophistication and let the cozy embrace of timeless design whisk you away to provincial bliss.\""
]
}
}
```
## <a id="design-styles"> Supported Design Styles
Decor8 AI supports following design styles. Learn more about these styles at [Decor8 AI Decoration Styles](https://www.decor8.ai/interior-decoration-styles/)
| **Design Styles** | | | |
|---------------------|--------------------|--------------------|--------------------|
| minimalist | scandinavian | industrial | boho |
| traditional | artdeco | midcenturymodern | coastal |
| tropical | eclectic | contemporary | frenchcountry |
| rustic | shabbychic | vintage | country |
| modern | asian_zen | hollywoodregency | bauhaus |
| mediterranean | farmhouse | victorian | gothic |
| moroccan | southwestern | transitional | maximalist |
| arabic | japandi | retrofuturism | artnouveau |
## <a id="room-types"> Supported Room Types
Decor8 AI supports following room types. Learn more about these room types at [Decor8 AI Room Types](https://www.decor8.ai/rooms)
| **Room Type** | | | |
|----------------|---------------|---------------|---------------|
| livingroom | kitchen | diningroom | bedroom |
| bathroom | kidsroom | familyroom | readingnook |
| sunroom | walkincloset | mudroom | toyroom |
| office | foyer | powderroom | laundryroom |
| gym | basement | garage | balcony |
| cafe | homebar | study_room | front_porch |
| back_porch | back_patio | | |
## <a id="color-schemes"> Supported Color Schemes
Decor8 AI supports following color schemes.
| Color Scheme Value | Description |
|--------------------|-----------------------------|
| COLOR_SCHEME_0 | Default |
| COLOR_SCHEME_1 | Moss Green, Tan, White |
| COLOR_SCHEME_2 | Gray, Sand, Blue |
| COLOR_SCHEME_3 | Hunter Green, Red |
| COLOR_SCHEME_4 | White, Pops of Color |
| COLOR_SCHEME_5 | Blue, Neon |
| COLOR_SCHEME_6 | Light Blue, Emerald |
| COLOR_SCHEME_7 | Blue, Grass Green |
| COLOR_SCHEME_8 | Blue, Beige |
| COLOR_SCHEME_9 | Gray, Brown |
| COLOR_SCHEME_10 | Black, Red |
| COLOR_SCHEME_11 | Gray-Green, White, Black |
| COLOR_SCHEME_12 | Blue, Gray, Taupe |
| COLOR_SCHEME_13 | Black, Navy |
| COLOR_SCHEME_14 | Emerald, Tan |
| COLOR_SCHEME_15 | Forest Green, Light Gray |
| COLOR_SCHEME_16 | Yellow, Gray |
| COLOR_SCHEME_17 | Pink, Green |
| COLOR_SCHEME_18 | Blush Pink, Black |
| COLOR_SCHEME_19 | Black, White |
| COLOR_SCHEME_20 | Blue, White |
## <a id="speciality-decor"> Supported Seasonal / Special Décor
Decor8 AI supports following seasonal décor.
| Speciality Decor Value | Description |
|------------------------|----------------------------------------------------------------------|
| SPECIALITY_DECOR_0 | None |
| SPECIALITY_DECOR_1 | Halloween Decor with Spooky Ambiance, Eerie Elements, Dark Colors, and Festive Accents |
| SPECIALITY_DECOR_2 | Christmas Decor with Christmas Tree, Ornaments, and Lights |
| SPECIALITY_DECOR_3 | Thanksgiving Decor, Fall Season Decor |
| SPECIALITY_DECOR_4 | Fall Season Decor |
| SPECIALITY_DECOR_5 | Spring Season Decor |
| SPECIALITY_DECOR_6 | Summer Season Decor |
| SPECIALITY_DECOR_7 | Winter Season Decor |
Raw data
{
"_id": null,
"home_page": "https://www.decor8.ai",
"name": "decor8ai",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": null,
"author": "Akhilesh Joshi",
"author_email": "akhilesh@immex.tech",
"download_url": "https://files.pythonhosted.org/packages/87/af/9a9d92d377cd1da1ad3d701398ee36530aefd6fbde7ee5bb39f999bd78cd/decor8ai-0.24.tar.gz",
"platform": null,
"description": "# Decor8 AI Python SDK\n\n## Table of Contents\n- [Overview](#python-sdk-overview)\n- [Installation](#installation)\n- [Configuration](#configure-sdk)\n- [Usage](#using-this-sdk)\n - [Design With Photo](#design-with-photo)\n - [Design Without Photo](#design-without-photo)\n - [Priming the walls](#prime-the-walls)\n - [Upscale the image](#upscale-the-image)\n - [Generate Captions for the image](#generate-captions-for-the-interior-image)\n- [Design Styles](#design-styles)\n- [Room Types](#room-types)\n- [Color Schemes](#color-schemes)\n- [Seasonal D\u00e9cor](#speciality-decor)\n\n\nDecor8 AI is a cutting-edge interior design app that revolutionizes your design experience. It offers a rich tapestry of customization options allowing you to visualize and craft interiors that echo your style and imagination. \n\nYou can choose from 35+ interior design styles and 20+ room types to create unique interior design styles for your space.\n\nThe app specializes in virtual staging, transforming empty spaces into vivid, attractive interiors, enhancing their appeal for better marketability. \n\nEquipped with a powerful Python SDK, Decor8 AI facilitates seamless integrations, enabling enhanced design generation capabilities directly within your Python environment. Its user-friendly interface is optimized for performance on smaller screens, ensuring that your design process is as effortless and efficient as possible.\n\nThis documentation describes how you can use Decor8 AI Python SDK to integrate Decor8 AI's powerful features in your application. \n\nSee [complete documentation for Decor8 AI api for Virtual Staging and Interior Design](https://api-docs.decor8.ai/). Please reach out to [Decor8 AI Team](mailto:decor8@immex.tech) with questions or suggestions. \n\n## <a id=\"installation\"></a>Installation\n\nYou can install the Decor8 AI Python SDK using pip:\n\n```bash\npip install decor8ai\n```\n\n## <a id=\"configure-sdk\"></a>Configure Decor8 AI API key\n\n### Sign in to [Decor8 AI](https://prod-app.decor8.ai)\n\n### Click on Profile Photo on Top Left\n\n\n\n### Click Generate API Key\n\n\n\n## <a id=\"using-this-sdk\">Usage\n\n```bash\nexport DECOR8AI_API_KEY='<YOUR_API_KEY>'\n```\n\n## <a id=\"design-with-photo\"> Generating Interior Design with a Photo of the room\n\n```python\nfrom decor8ai.client import generate_designs_for_room\n\n# Mandatory Parameters\ninput_image_url = 'https://prod-files.decor8.ai/test-images/sdk_test_image.png' #local-file-path or URL or bytes\nroom_type = 'livingroom' # See below for all supported room types\ndesign_style = 'frenchcountry' # See below for all supported design Styles\nnum_images = 1 # Up to 4 images can be generated at a time\n\n# Optional Parameters\nnum_captions = None # Choose 1 or 2 for number of image captions to generate\nkeep_original_dimensions = False # Optional. True or False. Generated designs retain original image's dimensions (and aspect ratio)\ncolor_scheme = 'COLOR_SCHEME_5' # Optional\nspeciality_decor = 'SPECIALITY_DECOR_5' # Optional\nmask_info = None #Optional. Use mask_info string returned by first invocation of generate_designs_for_room api. Helpful in speeding up api response time.\n\nresponse_json = generate_designs_for_room(input_image_url=input_image_url, mask_info=mask_info, room_type=room_type, design_style=design_style, num_images=num_images, keep_original_dimensions=True, color_scheme=color_scheme, speciality_decor=speciality_decor)\n\n```\n\n```\nThe response is a JSON object containing the generated designs and other information.\n\nSample response for successful design generation\n\n{\n \"error\": \"\",\n \"message\": \"Successfully generated designs.\",\n \"info\":\n {\n \"images\":\n [\n {\n \"uuid\": \"81133196-4477-4cdd-834a-89f5482bb9d0\",\n \"url\": \"http://<generated-image-path>\",\n \"width\": 768,\n \"height\": 512\n }\n ]\n }\n}\n\nSample response when unsuccessful. \"error\" will be non-empty value.\n{\n \"error\": \"InvalidInput\",\n \"message\": \"Invalid input image. Please check the input image and try again.\",\n}\n```\n\n\n## <a id=\"design-without-photo\"> Generating Inspirational Interior Design Ideas without using a photo of the room\n\n```Python\nfrom decor8ai.client import generate_designs\n\n# Here, we don't provide input image. The API generates a new interior design using following parameters.\nroom_type = 'livingroom' # See below for all supported room types\ndesign_style = 'frenchcountry' # See below for all supported design Styles\nnum_images = 1 # Up to 4 images can be generated at a time\n\n# Optional Parameters\nnum_captions = None # Choose 1 or 2 for number of image captions to generate\n\nresponse_json = generate_designs(room_type=room_type, design_style=design_style, num_images=num_images, num_captions=1)\n\n# If you like HTTP URLs for output, use new API\nfrom decor8ai.client import generate_inspirational_designs\nresponse_json = generate_inspirational_designs(room_type=room_type, design_style=design_style, num_images=num_images)\n```\n\n## <a id=\"prime-the-walls\">Priming the walls\n\nIf your room contains unfinished walls, unpainted walls or walls which need touch-up, use this API to get walls with basic white colored, smooth textured walls or as it's called 'primed walls'. \n\nYou can use the returned image as input to generate_designs API for filling it with furniture. \n\n```Python\nfrom decor8ai.client import prime_walls_for_room\n\ninput_image_url = 'http://example.com/path/to/your/image.png' #local-file-path or URL or bytes\nresponse_json = prime_walls_for_room(input_image_url=input_image_url)\n\n```\n## <a id=\"upscale-the-image\">Upscale the image\nAI generated designs may have a smaller resolution for some use-cases. Use this API to get upto 4x the original resolution of the image. Original images of upto maximum 1024px width or height or both are supported. \n\n```Python\nfrom decor8ai.client import upscale_image\n\ninput_image = 'path/to/your/image.png' #local-file-path or URL or bytes\nscale_factor = 2\n\nresponse = upscale_image(input_image, scale_factor)\n```\n\n## <a id=\"image-caption-generator\">Generate captions for the interior image\nIf you need apt captions for an image depicting a specific interior design style in a room, use this API. \n\n```Python\nfrom decor8ai.client import generate_image_captions\n\nroom_type = 'livingroom'\ndesign_style = 'frenchcountry'\nnum_captions = 2\n\nresponse = generate_image_captions(room_type, design_style, num_captions)\n\n```\n\n```Text\nSample output\n\n{\n \"error\": \"\",\n \"message\": \"Successfully generated image captions.\",\n \"info\":\n {\n \"captions\":\n [\n \"\\\"Enchanting French Country Charm: Where cozy meets elegance in the heart of the living room.\\\"\",\n \"\\\"Step into a Parisian dream - where charm, elegance, and comfort seamlessly blend in this enchanting French country living room retreat. Get ready to indulge in rustic sophistication and let the cozy embrace of timeless design whisk you away to provincial bliss.\\\"\"\n ]\n }\n}\n```\n\n## <a id=\"design-styles\"> Supported Design Styles\n\nDecor8 AI supports following design styles. Learn more about these styles at [Decor8 AI Decoration Styles](https://www.decor8.ai/interior-decoration-styles/)\n\n| **Design Styles** | | | |\n|---------------------|--------------------|--------------------|--------------------|\n| minimalist | scandinavian | industrial | boho |\n| traditional | artdeco | midcenturymodern | coastal |\n| tropical | eclectic | contemporary | frenchcountry |\n| rustic | shabbychic | vintage | country |\n| modern | asian_zen | hollywoodregency | bauhaus |\n| mediterranean | farmhouse | victorian | gothic |\n| moroccan | southwestern | transitional | maximalist |\n| arabic | japandi | retrofuturism | artnouveau |\n\n## <a id=\"room-types\"> Supported Room Types\nDecor8 AI supports following room types. Learn more about these room types at [Decor8 AI Room Types](https://www.decor8.ai/rooms)\n\n| **Room Type** | | | |\n|----------------|---------------|---------------|---------------|\n| livingroom | kitchen | diningroom | bedroom |\n| bathroom | kidsroom | familyroom | readingnook |\n| sunroom | walkincloset | mudroom | toyroom |\n| office | foyer | powderroom | laundryroom |\n| gym | basement | garage | balcony |\n| cafe | homebar | study_room | front_porch |\n| back_porch | back_patio | | |\n\n\n## <a id=\"color-schemes\"> Supported Color Schemes\nDecor8 AI supports following color schemes.\n\n| Color Scheme Value | Description |\n|--------------------|-----------------------------|\n| COLOR_SCHEME_0 | Default |\n| COLOR_SCHEME_1 | Moss Green, Tan, White |\n| COLOR_SCHEME_2 | Gray, Sand, Blue |\n| COLOR_SCHEME_3 | Hunter Green, Red |\n| COLOR_SCHEME_4 | White, Pops of Color |\n| COLOR_SCHEME_5 | Blue, Neon |\n| COLOR_SCHEME_6 | Light Blue, Emerald |\n| COLOR_SCHEME_7 | Blue, Grass Green |\n| COLOR_SCHEME_8 | Blue, Beige |\n| COLOR_SCHEME_9 | Gray, Brown |\n| COLOR_SCHEME_10 | Black, Red |\n| COLOR_SCHEME_11 | Gray-Green, White, Black |\n| COLOR_SCHEME_12 | Blue, Gray, Taupe |\n| COLOR_SCHEME_13 | Black, Navy |\n| COLOR_SCHEME_14 | Emerald, Tan |\n| COLOR_SCHEME_15 | Forest Green, Light Gray |\n| COLOR_SCHEME_16 | Yellow, Gray |\n| COLOR_SCHEME_17 | Pink, Green |\n| COLOR_SCHEME_18 | Blush Pink, Black |\n| COLOR_SCHEME_19 | Black, White |\n| COLOR_SCHEME_20 | Blue, White |\n\n## <a id=\"speciality-decor\"> Supported Seasonal / Special D\u00e9cor\nDecor8 AI supports following seasonal d\u00e9cor.\n\n| Speciality Decor Value | Description |\n|------------------------|----------------------------------------------------------------------|\n| SPECIALITY_DECOR_0 | None |\n| SPECIALITY_DECOR_1 | Halloween Decor with Spooky Ambiance, Eerie Elements, Dark Colors, and Festive Accents |\n| SPECIALITY_DECOR_2 | Christmas Decor with Christmas Tree, Ornaments, and Lights |\n| SPECIALITY_DECOR_3 | Thanksgiving Decor, Fall Season Decor |\n| SPECIALITY_DECOR_4 | Fall Season Decor |\n| SPECIALITY_DECOR_5 | Spring Season Decor |\n| SPECIALITY_DECOR_6 | Summer Season Decor |\n| SPECIALITY_DECOR_7 | Winter Season Decor |\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Decor8 AI is an AI Interior Design Tool. With Decor8 AI Python SDK, you can automate interior design generation tasks for room photos.",
"version": "0.24",
"project_urls": {
"Homepage": "https://www.decor8.ai",
"Repository": "https://github.com/immex-tech/decor8ai-sdk"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d7ccafb9d3cc2ae7b3c6d0736bf862f65e29ee7a79d0a6b81e6e5d5da811a35d",
"md5": "0b45f3644d84947d1c12f41fad980ac9",
"sha256": "eb8a6c273c6cf46d671b4d953cee1049c497678fa753d7239132e948c98e18c2"
},
"downloads": -1,
"filename": "decor8ai-0.24-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0b45f3644d84947d1c12f41fad980ac9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 6185,
"upload_time": "2024-08-07T19:06:01",
"upload_time_iso_8601": "2024-08-07T19:06:01.772177Z",
"url": "https://files.pythonhosted.org/packages/d7/cc/afb9d3cc2ae7b3c6d0736bf862f65e29ee7a79d0a6b81e6e5d5da811a35d/decor8ai-0.24-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "87af9a9d92d377cd1da1ad3d701398ee36530aefd6fbde7ee5bb39f999bd78cd",
"md5": "03504a5b66811f167a23c93ab6ca888a",
"sha256": "72c7e96899428bceafa86d233bd237072f81066aee37df68db54848f620e2540"
},
"downloads": -1,
"filename": "decor8ai-0.24.tar.gz",
"has_sig": false,
"md5_digest": "03504a5b66811f167a23c93ab6ca888a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 5720,
"upload_time": "2024-08-07T19:06:03",
"upload_time_iso_8601": "2024-08-07T19:06:03.124922Z",
"url": "https://files.pythonhosted.org/packages/87/af/9a9d92d377cd1da1ad3d701398ee36530aefd6fbde7ee5bb39f999bd78cd/decor8ai-0.24.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-07 19:06:03",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "immex-tech",
"github_project": "decor8ai-sdk",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "decor8ai"
}
