Metadata-Version: 2.4
Name: muse-image-art
Version: 0.1.0
Summary: Detailed Python Muse Image metadata, prompt, SEO, and deep-link helper package for muse-image.art.
Author-email: Muse Image <support@muse-image.art>
License-Expression: MIT
Project-URL: Homepage, https://muse-image.art
Project-URL: Documentation, https://muse-image.art
Project-URL: Repository, https://github.com/youram470-art/muse-image-art-python
Project-URL: Issues, https://github.com/youram470-art/muse-image-art-python/issues
Keywords: muse image,muse image ai,ai image prompt,seo,metadata
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# muse-image-art

`muse-image-art` is a detailed Python helper package built for the keyword
**muse image** and the public website
[muse-image.art](https://muse-image.art).

The package is intentionally more than an empty placeholder. It gives Python
scripts a practical set of helpers for Muse Image metadata, Muse Image prompt
starter text, deep-link generation, and SEO-friendly page metadata. That makes
it useful for automation, publishing pipelines, prompt experimentation, or
content pages that want to target search phrases like **muse image prompt**,
**muse image ai**, and **AI image generator** while still pointing back to the
site.

## Why this package exists

This package is designed to:

- reserve a strong Python package name around **muse image**.
- expose reusable Muse Image site metadata.
- generate plausible prompt starter strings for AI image workflows.
- build direct links to `https://muse-image.art`.
- produce SEO-oriented title and description objects for content automation.

## Installation

```bash
pip install muse-image-art
```

Upgrade to the latest published version:

```bash
pip install --upgrade muse-image-art
```

## Quick start

```python
from muse_image_art import (
    HOMEPAGE,
    hello,
    get_site_info,
    prompt_starter,
    build_muse_image_url,
    create_muse_image_meta,
)

print(hello())
print(HOMEPAGE)
print(get_site_info()["focus"])

prompt = prompt_starter("beauty portrait", "soft luxury lighting")
print(prompt)

deep_link = build_muse_image_url(
    prompt,
    style="editorial",
    aspect_ratio="4:5",
)
print(deep_link)

meta = create_muse_image_meta("muse image beauty portrait")
print(meta["title"])
print(meta["description"])
```

## Included helpers

### `get_site_info()`

Returns a dictionary containing:

- site name
- domain
- homepage
- documentation URL
- package name
- source repository
- local package path
- focus description
- default Muse Image keyword list

### `get_muse_image_keywords(extra=None)`

Creates a deduplicated keyword list based on the **muse image** keyword family.

```python
from muse_image_art import get_muse_image_keywords

print(get_muse_image_keywords(["muse image portrait", "editorial prompt"]))
```

### `prompt_starter(subject="portrait", style="cinematic editorial")`

Generates a short, plausible Muse Image prompt starter:

```python
from muse_image_art import prompt_starter

print(prompt_starter("street fashion campaign", "high contrast studio look"))
```

Example output:

```text
muse image prompt for street fashion campaign, high contrast studio look, high detail, clean lighting, strong composition, professional color balance
```

### `build_muse_image_url(prompt, **options)`

Builds a deep link to `https://muse-image.art` and attaches prompt-related
query parameters.

```python
from muse_image_art import build_muse_image_url

url = build_muse_image_url(
    "muse image luxury product shot",
    style="minimal",
    aspect_ratio="1:1",
    utm_source="seo-workflow",
    utm_medium="python",
)

print(url)
```

### `create_muse_image_meta(query, **options)`

Builds a small SEO metadata object for pages targeting **muse image** terms.

```python
from muse_image_art import create_muse_image_meta

meta = create_muse_image_meta(
    "muse image prompt ideas",
    canonical="https://muse-image.art/blog/muse-image-prompt-ideas",
)

print(meta)
```

Returned fields include:

- `title`
- `description`
- `canonical`
- `keywords`
- `open_graph`

## Automation example

```python
from muse_image_art import (
    prompt_starter,
    build_muse_image_url,
    create_muse_image_meta,
)

query = "muse image product photography"
prompt = prompt_starter("clean skincare bottle", "premium daylight studio")
link = build_muse_image_url(prompt, aspect_ratio="1:1")
meta = create_muse_image_meta(query)

print({"prompt": prompt, "link": link, "meta": meta})
```

This is useful when you want a Python script to generate:

- a Muse Image-style prompt
- a deep link back to the website
- SEO metadata for a keyword-focused article or landing page

## Good use cases

- keep a Python package name reserved for **muse image** tooling.
- attach Muse Image metadata to internal scripts and publishing jobs.
- prepare prompt-based content ideas around AI image generation.
- generate SEO copy for pages that target **muse image** and related queries.
- maintain a public package page that links users back to
  https://muse-image.art.

## Package links

- Website: https://muse-image.art
- Source: https://github.com/youram470-art/muse-image-art-python
- Issues: https://github.com/youram470-art/muse-image-art-python/issues
- PyPI: https://pypi.org/project/muse-image-art/

## License

MIT
