@felores/kie-cli 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) 2024 andrewlwn77
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,67 @@
1
+ # @felores/kie-cli
2
+
3
+ Standalone command-line interface for the [Kie.ai](https://kie.ai) APIs: generate
4
+ images, video, music and speech from your terminal. Same models as the
5
+ [`@felores/kie-ai-mcp-server`](https://www.npmjs.com/package/@felores/kie-ai-mcp-server)
6
+ MCP server, no MCP client required.
7
+
8
+ The CLI and the MCP server are generated from one shared tool registry, so both
9
+ always expose the exact same tools. They install and run completely
10
+ independently.
11
+
12
+ ## Install
13
+
14
+ ```bash
15
+ npm install -g @felores/kie-cli
16
+ ```
17
+
18
+ ## Setup
19
+
20
+ ```bash
21
+ export KIE_AI_API_KEY="your-key"
22
+ ```
23
+
24
+ Optional: `KIE_AI_BASE_URL`, `KIE_AI_TIMEOUT`, `KIE_AI_DB_PATH`, `KIE_AI_CALLBACK_URL`.
25
+
26
+ ## Usage
27
+
28
+ ```bash
29
+ # List every tool (commands map 1:1 to the MCP tools)
30
+ kie-cli --help
31
+
32
+ # See the flags for a tool (derived from its schema)
33
+ kie-cli nano_banana_image --help
34
+
35
+ # Generate an image
36
+ kie-cli nano_banana_image --prompt "a red panda coding at night" --resolution 2K
37
+
38
+ # Generate a video, then poll the task
39
+ kie-cli veo3_generate_video --prompt "drone shot over a canyon at sunrise"
40
+ kie-cli get_task_status --task_id <id>
41
+
42
+ # List recent tasks
43
+ kie-cli list_tasks --limit 10
44
+ ```
45
+
46
+ ### JSON output
47
+
48
+ Add `--json` to print the raw tool result (machine-readable, ideal for piping to
49
+ `jq` or other agents):
50
+
51
+ ```bash
52
+ kie-cli list_tasks --json | jq '.tasks'
53
+ ```
54
+
55
+ Tools that return a `success: false` payload set a non-zero exit code.
56
+
57
+ ## Available tools
58
+
59
+ Run `kie-cli --help` for the current list. Tools are grouped by category
60
+ (`image`, `video`, `audio`, `utility`) and include Nano Banana, Veo3, Suno,
61
+ ElevenLabs, ByteDance Seedance/Seedream, Qwen, Runway Aleph, Midjourney, Wan,
62
+ Hailuo, Kling, GPT Image 2, Flux Kontext, Recraft, Ideogram, Topaz, HappyHorse
63
+ and more.
64
+
65
+ ## License
66
+
67
+ MIT
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ export {};