ai-img 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Saatvik Arya
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,91 @@
1
+ # ai-img
2
+
3
+ AI Image Generation CLI with bunli + AI SDK. Supports OpenAI, Google (Gemini), and Fal AI.
4
+
5
+ ## Install CLI
6
+
7
+ ```bash
8
+ # Install globally with Bun (recommended)
9
+ bun add -g ai-img
10
+
11
+ # Or clone and install locally
12
+ git clone https://github.com/aryasaatvik/ai-img
13
+ cd ai-img
14
+ bun install
15
+ bun run build
16
+ ```
17
+
18
+ ## Usage
19
+
20
+ ```bash
21
+ # Generate an image
22
+ ai-img generate -p "a cat sitting on a chair" -o cat.png
23
+
24
+ Add to your AI agent skills:
25
+
26
+ ```bash
27
+ # For Claude Code
28
+ npx skills add aryasaatvik/ai-img -a claude-code
29
+
30
+ # For OpenCode
31
+ npx skills add aryasaatvik/ai-img -a opencode
32
+
33
+ # For all agents
34
+ npx skills add aryasaatvik/ai-img
35
+ ```
36
+
37
+ Or install locally:
38
+
39
+ ```bash
40
+ npx skills add ./skills/ai-image-gen
41
+ ```
42
+
43
+ See [skills/ai-image-gen](./skills/ai-image-gen/) for full skill documentation.
44
+
45
+ ```bash
46
+ bun install
47
+ bun run build
48
+ ```
49
+
50
+ ## Usage
51
+
52
+ ```bash
53
+ # Generate an image
54
+ ai-img generate -p "a cat sitting on a chair" -o cat.png
55
+
56
+ # Generate with specific provider
57
+ ai-img generate -p "a sunset" -P google -o sunset.png
58
+
59
+ # Edit an image
60
+ ai-img edit -p "make it blue" -i input.png -o output.png
61
+
62
+ # Batch process from JSONL
63
+ ai-img batch -i jobs.jsonl -o output/
64
+ ```
65
+
66
+ ## Providers
67
+
68
+ Set your API key via environment variable:
69
+ - OpenAI: `OPENAI_API_KEY`
70
+ - Google: `GEMINI_API_KEY` or `GOOGLE_API_KEY`
71
+ - Fal: `FAL_API_KEY`
72
+
73
+ ## Options
74
+
75
+ ### generate
76
+ - `-p, --prompt` - Text prompt (required)
77
+ - `-P, --provider` - AI provider (openai, google, fal)
78
+ - `-m, --model` - Model ID
79
+ - `-s, --size` - Image size (e.g., 1024x1024)
80
+ - `-c, --count` - Number of images
81
+ - `-o, --output` - Output file path
82
+
83
+ ### edit
84
+ - `-p, --prompt` - Edit prompt (required)
85
+ - `-i, --input` - Input image path (required)
86
+ - `-m, --mask` - Mask image for partial edits
87
+
88
+ ### batch
89
+ - `-i, --input` - JSONL file with one job per line
90
+ - `-o, --outDir` - Output directory
91
+ - `-c, --concurrency` - Concurrent API calls