vcursor-cli 1.0.0__tar.gz

vcursor_cli-1.0.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+recursive-include vcursor *.py
+recursive-include tests *.py

vcursor_cli-1.0.0/PKG-INFO

@@ -0,0 +1,139 @@
+Metadata-Version: 2.4
+Name: vcursor-cli
+Version: 1.0.0
+Summary: VCursor SDK & CLI - Generate videos from text, images, and URLs using AI
+Author-email: Julius <support@vcursor.com>
+License: MIT
+Project-URL: Homepage, https://cli.vcursor.com
+Project-URL: Repository, https://github.com/JThh/vcursor
+Project-URL: Documentation, https://cli.vcursor.com/docs
+Keywords: video,ai,generation,cli,vcursor,sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.25.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+
+# VCursor Python SDK & CLI
+
+Generate videos from text, images, and URLs using AI.
+
+## Installation
+
+```bash
+pip install vcursor
+```
+
+## Quick Start
+
+### As a library (embedded in code)
+
+```python
+from vcursor import VCursor
+
+client = VCursor(api_key="vk-...")
+
+# Submit a video generation task
+resp = client.submit("a cat playing piano in a jazz club")
+
+# Wait for completion with progress callback
+result = client.wait_for_completion(
+    resp.task_id,
+    on_progress=lambda p: print(f"{p.data.progress}%")
+)
+
+print(result.data.products.url)
+```
+
+### Async usage
+
+```python
+import asyncio
+from vcursor import VCursorAsync
+
+async def main():
+    async with VCursorAsync(api_key="vk-...") as client:
+        resp = await client.submit("sunset timelapse over mountains")
+        result = await client.wait_for_completion(resp.task_id)
+        print(result.data.products.url)
+
+asyncio.run(main())
+```
+
+### Concurrency limiting
+
+The server enforces per-user rate limits based on subscription tier:
+
+| Tier | Standard Requests | Agent Requests | Window    |
+|------|-------------------|----------------|-----------|
+| Free | 3                 | 1              | Lifetime  |
+| Pro  | 30/hr             | 5/hr           | Rolling 1h|
+| Plus | 120/hr            | 15/hr          | Rolling 1h|
+
+```python
+# Check current rate limit status
+status = client.check_concurrency("standard")
+print(f"Standard: {status.summary['standard'].used}/{status.summary['standard'].limit}")
+print(f"Agent:    {status.summary['agent'].used}/{status.summary['agent'].limit}")
+
+# Client-side limit (capped at server limit)
+client = VCursor(api_key="vk-...", max_concurrency=10)
+```
+
+### As a CLI
+
+```bash
+# Authenticate
+vcursor login
+
+# Generate a video
+vcursor generate "a cat playing piano"
+
+# Agent mode
+vcursor generate --agent "create a 30s commercial"
+
+# Check concurrency status
+vcursor concurrency
+
+# With concurrency limit
+vcursor generate --max-concurrency 2 "sunset timelapse"
+```
+
+## API Reference
+
+### `VCursor` / `VCursorAsync`
+
+| Method                    | Description                            |
+|---------------------------|----------------------------------------|
+| `submit(prompt, **kw)`   | Submit a standard video generation task |
+| `get_progress(task_id)`  | Get task progress                      |
+| `wait_for_completion()`  | Poll until task completes              |
+| `cancel_task(task_id)`   | Cancel a running task                  |
+| `submit_agent(message)`  | Submit an agent mode task              |
+| `get_agent_progress()`   | Get agent task progress                |
+| `wait_for_agent_completion()` | Poll until agent task completes   |
+| `check_concurrency()`    | Check concurrency limit status         |
+
+## Configuration
+
+Config is stored in `~/.vcursor/config.json` (shared with the Node.js CLI).
+
+Environment variables:
+- `VCURSOR_API_KEY` - API key
+- `VCURSOR_SERVER` - Server URL
+
+## License
+
+MIT

vcursor_cli-1.0.0/README.md

@@ -0,0 +1,111 @@
+# VCursor Python SDK & CLI
+
+Generate videos from text, images, and URLs using AI.
+
+## Installation
+
+```bash
+pip install vcursor
+```
+
+## Quick Start
+
+### As a library (embedded in code)
+
+```python
+from vcursor import VCursor
+
+client = VCursor(api_key="vk-...")
+
+# Submit a video generation task
+resp = client.submit("a cat playing piano in a jazz club")
+
+# Wait for completion with progress callback
+result = client.wait_for_completion(
+    resp.task_id,
+    on_progress=lambda p: print(f"{p.data.progress}%")
+)
+
+print(result.data.products.url)
+```
+
+### Async usage
+
+```python
+import asyncio
+from vcursor import VCursorAsync
+
+async def main():
+    async with VCursorAsync(api_key="vk-...") as client:
+        resp = await client.submit("sunset timelapse over mountains")
+        result = await client.wait_for_completion(resp.task_id)
+        print(result.data.products.url)
+
+asyncio.run(main())
+```
+
+### Concurrency limiting
+
+The server enforces per-user rate limits based on subscription tier:
+
+| Tier | Standard Requests | Agent Requests | Window    |
+|------|-------------------|----------------|-----------|
+| Free | 3                 | 1              | Lifetime  |
+| Pro  | 30/hr             | 5/hr           | Rolling 1h|
+| Plus | 120/hr            | 15/hr          | Rolling 1h|
+
+```python
+# Check current rate limit status
+status = client.check_concurrency("standard")
+print(f"Standard: {status.summary['standard'].used}/{status.summary['standard'].limit}")
+print(f"Agent:    {status.summary['agent'].used}/{status.summary['agent'].limit}")
+
+# Client-side limit (capped at server limit)
+client = VCursor(api_key="vk-...", max_concurrency=10)
+```
+
+### As a CLI
+
+```bash
+# Authenticate
+vcursor login
+
+# Generate a video
+vcursor generate "a cat playing piano"
+
+# Agent mode
+vcursor generate --agent "create a 30s commercial"
+
+# Check concurrency status
+vcursor concurrency
+
+# With concurrency limit
+vcursor generate --max-concurrency 2 "sunset timelapse"
+```
+
+## API Reference
+
+### `VCursor` / `VCursorAsync`
+
+| Method                    | Description                            |
+|---------------------------|----------------------------------------|
+| `submit(prompt, **kw)`   | Submit a standard video generation task |
+| `get_progress(task_id)`  | Get task progress                      |
+| `wait_for_completion()`  | Poll until task completes              |
+| `cancel_task(task_id)`   | Cancel a running task                  |
+| `submit_agent(message)`  | Submit an agent mode task              |
+| `get_agent_progress()`   | Get agent task progress                |
+| `wait_for_agent_completion()` | Poll until agent task completes   |
+| `check_concurrency()`    | Check concurrency limit status         |
+
+## Configuration
+
+Config is stored in `~/.vcursor/config.json` (shared with the Node.js CLI).
+
+Environment variables:
+- `VCURSOR_API_KEY` - API key
+- `VCURSOR_SERVER` - Server URL
+
+## License
+
+MIT

vcursor_cli-1.0.0/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "vcursor-cli"
+version = "1.0.0"
+description = "VCursor SDK & CLI - Generate videos from text, images, and URLs using AI"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.9"
+authors = [
+    {name = "Julius", email = "support@vcursor.com"},
+]
+keywords = ["video", "ai", "generation", "cli", "vcursor", "sdk"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Multimedia :: Video",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "httpx>=0.25.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-asyncio>=0.21",
+]
+
+[project.urls]
+Homepage = "https://cli.vcursor.com"
+Repository = "https://github.com/JThh/vcursor"
+Documentation = "https://cli.vcursor.com/docs"
+
+[project.scripts]
+vcursor = "vcursor.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["vcursor*"]

vcursor_cli-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

vcursor_cli-1.0.0/tests/test_types.py

@@ -0,0 +1,110 @@
+"""Basic tests for type serialization/deserialization."""
+
+from vcursor.types import (
+    SubmitRequest,
+    SubmitResponse,
+    TaskProgress,
+    AgentSubmitRequest,
+    AgentProgress,
+    ConcurrencyStatus,
+)
+
+
+def test_submit_request_to_dict():
+    req = SubmitRequest(prompt="hello world")
+    d = req.to_dict()
+    assert d == {"prompt": "hello world"}
+
+
+def test_submit_request_with_extras():
+    req = SubmitRequest(
+        prompt="test",
+        media_keys=["key1"],
+        reference_urls=["https://example.com"],
+        submission_mode="plan",
+    )
+    d = req.to_dict()
+    assert d["media_keys"] == ["key1"]
+    assert d["reference_urls"] == ["https://example.com"]
+    assert d["submission_mode"] == "plan"
+
+
+def test_submit_response_from_dict():
+    resp = SubmitResponse.from_dict({
+        "code": 200,
+        "message": "OK",
+        "task_id": "abc123",
+        "mode": "text2video",
+    })
+    assert resp.task_id == "abc123"
+    assert resp.mode == "text2video"
+
+
+def test_task_progress_from_dict():
+    progress = TaskProgress.from_dict({
+        "code": 200,
+        "message": "OK",
+        "data": {
+            "task_id": "t1",
+            "status": "processing",
+            "progress": 50.0,
+            "queuing_time": 1.0,
+            "remaining_process_time": 10.0,
+            "total_process_time": 20.0,
+            "products": {
+                "url": "https://cdn.example.com/video.mp4",
+                "upload_completed": True,
+            },
+        },
+    })
+    assert progress.data.status == "processing"
+    assert progress.data.progress == 50.0
+    assert progress.data.products.url == "https://cdn.example.com/video.mp4"
+
+
+def test_agent_submit_request_to_dict():
+    req = AgentSubmitRequest(message="make a commercial", duration="30s")
+    d = req.to_dict()
+    assert d == {"message": "make a commercial", "duration": "30s"}
+
+
+def test_agent_progress_from_dict():
+    p = AgentProgress.from_dict({
+        "task_id": "a1",
+        "status": "completed",
+        "progress": 100.0,
+        "video_url": "https://cdn.example.com/agent.mp4",
+    })
+    assert p.status == "completed"
+    assert p.video_url == "https://cdn.example.com/agent.mp4"
+
+
+def test_concurrency_status_from_dict():
+    s = ConcurrencyStatus.from_dict({
+        "allowed": True,
+        "limit": 30,
+        "used": 5,
+        "remaining": 25,
+        "category": "standard",
+        "tier": "pro",
+        "bypassEnabled": False,
+        "windowHours": 1,
+        "resetAt": None,
+        "summary": {
+            "standard": {"used": 5, "limit": 30, "remaining": 25},
+            "agent": {"used": 1, "limit": 5, "remaining": 4},
+        },
+    })
+    assert s.allowed is True
+    assert s.limit == 30
+    assert s.used == 5
+    assert s.remaining == 25
+    assert s.category == "standard"
+    assert s.tier == "pro"
+    assert s.bypass_enabled is False
+    assert s.window_hours == 1
+    assert s.summary is not None
+    assert s.summary["standard"].used == 5
+    assert s.summary["standard"].limit == 30
+    assert s.summary["agent"].used == 1
+    assert s.summary["agent"].limit == 5

vcursor_cli-1.0.0/vcursor/__init__.py

@@ -0,0 +1,25 @@
+"""VCursor SDK - Generate videos from text, images, and URLs using AI."""
+
+from vcursor.client import VCursor, VCursorAsync
+from vcursor.types import (
+    SubmitRequest,
+    SubmitResponse,
+    TaskProgress,
+    AgentSubmitRequest,
+    AgentProgress,
+    CategoryUsage,
+    ConcurrencyStatus,
+)
+
+__version__ = "1.0.0"
+__all__ = [
+    "VCursor",
+    "VCursorAsync",
+    "SubmitRequest",
+    "SubmitResponse",
+    "TaskProgress",
+    "AgentSubmitRequest",
+    "AgentProgress",
+    "CategoryUsage",
+    "ConcurrencyStatus",
+]