eightstatecli 0.4.0__py3-none-any.whl

eightstatecli-0.4.0.dist-info/METADATA

@@ -0,0 +1,177 @@
+Metadata-Version: 2.4
+Name: eightstatecli
+Version: 0.4.0
+Summary: Eightstate CLI — unified AI services from the command line
+Project-URL: Homepage, https://github.com/eight-state/eightstate
+Project-URL: Repository, https://github.com/eight-state/eightstate
+Author-email: Eightstate <hello@eightstate.co>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,cli,image-generation,research,transcription,web-search
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: openai>=1.0.0
+Description-Content-Type: text/markdown
+
+# escli
+
+```
+  ┌─────────────────────────────────┐
+  │  escli                  v0.3.1  │
+  │  eightstate command line        │
+  └─────────────────────────────────┘
+```
+
+AI services from the command line. Generate images, edit photos, and more. Works for humans and agents.
+
+## Install
+
+### macOS / Linux
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/eight-state/eightstate/main/cli/install.sh | bash
+```
+
+### Windows
+
+```powershell
+irm https://raw.githubusercontent.com/eight-state/eightstate/main/cli/install.ps1 | iex
+```
+
+### Manual install (any platform)
+
+```bash
+# requires uv (https://docs.astral.sh/uv)
+uv tool install git+https://github.com/eight-state/eightstate#subdirectory=cli
+
+# or with pip
+pip install git+https://github.com/eight-state/eightstate#subdirectory=cli
+```
+
+## Quickstart
+
+```bash
+# 1. authenticate
+escli auth login
+
+# 2. generate an image
+escli image gen "a sunset over the ocean" --open
+
+# 3. list models
+escli models
+```
+
+## Usage
+
+### Image Generation
+
+```bash
+escli i g "a mountain landscape"                    # square, auto-named
+escli i g "app mockup" -s portrait -q high --open   # portrait, opens after
+escli i g "logo design" -s sq -o logo.png           # named output
+escli i g "wallpaper" -s wide -f webp               # landscape webp
+escli i g "product photo" -q high -d ./output/      # to directory
+```
+
+### Image Editing
+
+```bash
+escli i e "make it snow" -i summer.jpg --open
+escli i e "repaint as oil painting" -i photo.jpg -q high -o painted.png
+escli i e "remove the background" -i product.png
+```
+
+### Sizes
+
+| Alias | Dimensions | Use case |
+|-------|-----------|----------|
+| `square`, `sq` | 1024x1024 | Logos, icons, social posts |
+| `landscape`, `wide`, `ls` | 1536x1024 | Wallpapers, banners, headers |
+| `portrait`, `tall`, `port` | 1024x1536 | Phone mockups, posters, stories |
+
+### Quality
+
+| Level | Speed | Detail |
+|-------|-------|--------|
+| `low` | ~15s | Fast drafts |
+| `medium` | ~25s | Balanced |
+| `high` | ~40s | Best quality |
+
+### Auth Profiles
+
+```bash
+escli auth login                        # interactive
+escli auth login --key sk-xxx           # non-interactive
+escli auth login --key sk-xxx -p work   # named profile
+escli auth status                       # show current (alias: whoami)
+escli auth profiles                     # list all (alias: ls)
+escli auth switch work                  # switch profile (alias: use)
+escli auth logout                       # remove current
+escli auth logout --all                 # remove everything
+```
+
+## Agent / CI Usage
+
+All commands support `--json` for structured output and `--quiet` for zero stderr noise:
+
+```bash
+# generate with pure JSON output
+escli --json --quiet i g "a logo" -s sq -o /tmp/logo.png
+
+# returns:
+# {"success": true, "path": "/abs/path/logo.png", "size_bytes": 123456,
+#  "elapsed_seconds": 18.4, "prompt": "a logo", "model": "gpt-image-2",
+#  "image_size": "1024x1024", "quality": "high"}
+
+# auth via env var (no login needed)
+ESCLI_API_KEY=sk-xxx escli --json models
+
+# non-interactive login for CI
+escli auth login --key $API_KEY --profile ci
+
+# edit with JSON output
+escli --json --quiet i e "make it blue" -i input.png -o output.png
+# {"success": true, "path": "/abs/path/output.png", "input": "/abs/path/input.png", ...}
+```
+
+**Exit codes:** `0` success, `1` error, `2` usage
+
+**Error JSON:** `{"success": false, "error": "message"}`
+
+## Shortcuts
+
+| Short | Full |
+|-------|------|
+| `escli i g` | `escli image generate` |
+| `escli i e` | `escli image edit` |
+| `escli a` | `escli auth` |
+| `escli m` | `escli models` |
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `ESCLI_API_KEY` | API key (overrides profile) | |
+| `ESCLI_BASE_URL` | API endpoint | `https://ai.eightstate.co/v1` |
+| `ESCLI_IMAGE_MODEL` | Default model | `gpt-image-2` |
+| `ESCLI_IMAGE_QUALITY` | Default quality | `high` |
+| `ESCLI_IMAGE_SIZE` | Default size | `1024x1024` |
+| `ESCLI_IMAGE_FORMAT` | Default format | `png` |
+| `ESCLI_OUT_DIR` | Output directory | `.` |
+| `ESCLI_TIMEOUT` | Timeout seconds | `300` |
+| `ESCLI_CONFIG_DIR` | Config directory | `~/.escli` |
+
+## Config
+
+Credentials stored at `~/.escli/config.json` with `600` permissions (owner-only read/write).
+
+## License
+
+MIT

eightstatecli-0.4.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+escli/__init__.py,sha256=TMNPjxiy_WruJ-yhvUa1zlDqkjrt7qajzE-WUKQC4FM,38923
+escli/__main__.py,sha256=ufE88bxvFQSSv3dJ06wkkcHvK5WG-1Xm_qxDfZgu99w,88
+escli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+escli/commands/audio.py,sha256=4P06Th5LThqypmz8w4ZzB0-bda1yX0w3Ci1pISAjQ7M,16310
+escli/commands/docs.py,sha256=53xUmBFChY6NOY4GcEI1yhn2AO14lBi3fbuxicdP9R0,12698
+escli/commands/research.py,sha256=aGx9xhcyNouocSRJ-a8m4bWnoGlGeh7-YFq7QQFUpWU,24698
+escli/commands/search.py,sha256=Ur4LwWXB9pAr1igoOgXLPMceJ5A-KPxE83Z3NhvL6dY,8762
+escli/commands/social.py,sha256=G7F8t594dHn9azW8mZplabuQXtjNA4OWssPD66WQmHk,8529
+escli/commands/usage.py,sha256=1VW1qQz4kYFkIqzJ4gwDkuYkuPblTd7aAJ96ltZHqiY,14704
+escli/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+escli/services/credentials.py,sha256=WT5UFkpufbXe8IATLIMmYKrp7YSm8_D2qg45KzqzXZk,3435
+escli/services/describe.py,sha256=Ngj53btgaKFb9PEmvS5mqihgQmSJqF05y_dcobKspfI,6610
+escli/services/output.py,sha256=13dUZM9K9dA-n3R_vzWMzKhApASwZDrhytOQeHFk9m8,5280
+eightstatecli-0.4.0.dist-info/METADATA,sha256=BtcS9CQDgoHqeoLSdi1VGAs57chRpd82m_W_wVIh4EY,5278
+eightstatecli-0.4.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+eightstatecli-0.4.0.dist-info/entry_points.txt,sha256=LnY9rCVY3LxmAdJbpKcL2MC4Q8IKvh8P37BQAeu3Vfc,37
+eightstatecli-0.4.0.dist-info/licenses/LICENSE,sha256=X6CJSLFXtYOTbyH5TGyT9DYB0Bu-i5SyrWgTZGdIn9E,1067
+eightstatecli-0.4.0.dist-info/RECORD,,

eightstatecli-0.4.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

eightstatecli-0.4.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+escli = escli:main

eightstatecli-0.4.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eightstate
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.