late-sdk 1.0.0__tar.gz

late_sdk-1.0.0/.env.example

@@ -0,0 +1,6 @@
+# Late API Configuration
+LATE_API_KEY=your_api_key_here
+
+# AI Provider (optional - for content generation)
+OPENAI_API_KEY=sk-your_openai_key_here
+# ANTHROPIC_API_KEY=sk-ant-your_anthropic_key_here

late_sdk-1.0.0/.gitignore

@@ -0,0 +1,83 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.env.local
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# ruff
+.ruff_cache/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project specific
+*.log

late_sdk-1.0.0/PKG-INFO

@@ -0,0 +1,277 @@
+Metadata-Version: 2.4
+Name: late-sdk
+Version: 1.0.0
+Summary: Python SDK for Late API - Social Media Scheduling
+Project-URL: Homepage, https://getlate.dev
+Project-URL: Documentation, https://docs.getlate.dev
+Project-URL: Repository, https://github.com/getlate/late-python-starter
+Project-URL: Issues, https://github.com/getlate/late-python-starter/issues
+Author-email: Late <hello@getlate.dev>
+License: MIT
+Keywords: api-client,facebook,instagram,late,linkedin,scheduling,social-media,tiktok,twitter,youtube
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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 :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: ai
+Requires-Dist: openai>=1.0.0; extra == 'ai'
+Provides-Extra: all
+Requires-Dist: anthropic>=0.40.0; extra == 'all'
+Requires-Dist: mcp>=1.0.0; extra == 'all'
+Requires-Dist: openai>=1.0.0; extra == 'all'
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.40.0; extra == 'anthropic'
+Provides-Extra: dev
+Requires-Dist: datamodel-code-generator>=0.26.0; extra == 'dev'
+Requires-Dist: mypy>=1.13.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest-cov>=6.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: respx>=0.21.0; extra == 'dev'
+Requires-Dist: ruff>=0.8.0; extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0.0; extra == 'mcp'
+Description-Content-Type: text/markdown
+
+# Late Python SDK
+
+Python SDK for [Late API](https://getlate.dev) - Schedule social media posts across multiple platforms.
+
+## Installation
+
+```bash
+pip install late-sdk
+```
+
+## Quick Start
+
+```python
+from late import Late
+
+client = Late(api_key="your_api_key")
+
+# List connected accounts
+accounts = client.accounts.list()
+
+# Create a scheduled post
+from datetime import datetime, timedelta
+
+post = client.posts.create(
+    content="Hello from Late!",
+    platforms=[{"platform": "twitter", "accountId": "your_account_id"}],
+    scheduled_for=datetime.now() + timedelta(hours=1),
+)
+```
+
+---
+
+## 🤖 Claude Desktop Integration (MCP)
+
+Schedule posts directly from Claude Desktop using natural language.
+
+### Setup in 3 Steps
+
+**1. Install uv** (package manager)
+
+```bash
+# macOS / Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Windows (PowerShell)
+powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+**2. Add to Claude Desktop config**
+
+Open the config file:
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+Add this:
+
+```json
+{
+  "mcpServers": {
+    "late": {
+      "command": "uvx",
+      "args": ["--from", "late-sdk[mcp]", "late-mcp"],
+      "env": {
+        "LATE_API_KEY": "your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+> Get your API key at [getlate.dev/dashboard/api-keys](https://getlate.dev/dashboard/api-keys)
+
+**3. Restart Claude Desktop**
+
+Done! Ask Claude things like:
+- *"Post 'Hello world!' to Twitter"*
+- *"Schedule a LinkedIn post for tomorrow at 9am"*
+- *"Show my connected accounts"*
+
+<details>
+<summary><b>Alternative: Using pip instead of uvx</b></summary>
+
+```bash
+pip install late-sdk[mcp]
+```
+
+```json
+{
+  "mcpServers": {
+    "late": {
+      "command": "python",
+      "args": ["-m", "late.mcp"],
+      "env": {
+        "LATE_API_KEY": "your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+</details>
+
+### Uploading Images/Videos
+
+Since Claude can't access local files, use the browser upload flow:
+
+1. Ask Claude: *"I want to post an image to Instagram"*
+2. Claude gives you an upload link → open it in your browser
+3. Upload your file and tell Claude *"done"*
+4. Claude creates the post with your media
+
+### Available Commands
+
+| Command | What it does |
+|---------|--------------|
+| `list_accounts` | Show connected social accounts |
+| `create_post` | Create scheduled or immediate post |
+| `publish_now` | Publish immediately |
+| `cross_post` | Post to multiple platforms |
+| `list_posts` | Show your posts |
+| `retry_post` | Retry a failed post |
+| `generate_upload_link` | Get link to upload media |
+
+---
+
+## SDK Features
+
+### Async Support
+
+```python
+import asyncio
+from late import Late
+
+async def main():
+    async with Late(api_key="...") as client:
+        posts = await client.posts.alist(status="scheduled")
+
+asyncio.run(main())
+```
+
+### AI Content Generation
+
+```bash
+pip install late-sdk[ai]
+```
+
+```python
+from late.ai import ContentGenerator, GenerateRequest
+
+generator = ContentGenerator(provider="openai", api_key="sk-...")
+
+response = generator.generate(
+    GenerateRequest(
+        prompt="Write a tweet about Python",
+        platform="twitter",
+        tone="casual",
+    )
+)
+
+print(response.text)
+```
+
+### CSV Scheduling
+
+```python
+from late import Late
+from late.pipelines import CSVSchedulerPipeline
+
+client = Late(api_key="...")
+pipeline = CSVSchedulerPipeline(client)
+
+# Validate first
+results = pipeline.schedule("posts.csv", dry_run=True)
+
+# Then schedule
+results = pipeline.schedule("posts.csv")
+```
+
+### Cross-Posting
+
+```python
+from late.pipelines import CrossPosterPipeline, PlatformConfig
+
+cross_poster = CrossPosterPipeline(client)
+
+results = await cross_poster.post(
+    content="Big announcement!",
+    platforms=[
+        PlatformConfig("twitter", "tw_123"),
+        PlatformConfig("linkedin", "li_456", delay_minutes=5),
+    ],
+)
+```
+
+---
+
+## API Reference
+
+### Resources
+
+| Resource | Methods |
+|----------|---------|
+| `client.posts` | `list`, `get`, `create`, `update`, `delete`, `retry` |
+| `client.profiles` | `list`, `get`, `create`, `update`, `delete` |
+| `client.accounts` | `list`, `get` |
+| `client.media` | `upload`, `upload_multiple` |
+| `client.analytics` | `get`, `get_usage` |
+| `client.tools` | `youtube_download`, `instagram_download`, `tiktok_download`, `generate_caption` |
+| `client.queue` | `get_slots`, `preview`, `next_slot` |
+
+### Client Options
+
+```python
+client = Late(
+    api_key="...",
+    timeout=30.0,      # seconds
+    max_retries=3,
+)
+```
+
+---
+
+## Links
+
+- [Late Website](https://getlate.dev)
+- [API Documentation](https://docs.getlate.dev)
+- [Get API Key](https://getlate.dev/dashboard/api-keys)
+
+## License
+
+MIT

late_sdk-1.0.0/README.md

@@ -0,0 +1,231 @@
+# Late Python SDK
+
+Python SDK for [Late API](https://getlate.dev) - Schedule social media posts across multiple platforms.
+
+## Installation
+
+```bash
+pip install late-sdk
+```
+
+## Quick Start
+
+```python
+from late import Late
+
+client = Late(api_key="your_api_key")
+
+# List connected accounts
+accounts = client.accounts.list()
+
+# Create a scheduled post
+from datetime import datetime, timedelta
+
+post = client.posts.create(
+    content="Hello from Late!",
+    platforms=[{"platform": "twitter", "accountId": "your_account_id"}],
+    scheduled_for=datetime.now() + timedelta(hours=1),
+)
+```
+
+---
+
+## 🤖 Claude Desktop Integration (MCP)
+
+Schedule posts directly from Claude Desktop using natural language.
+
+### Setup in 3 Steps
+
+**1. Install uv** (package manager)
+
+```bash
+# macOS / Linux
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Windows (PowerShell)
+powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
+```
+
+**2. Add to Claude Desktop config**
+
+Open the config file:
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+Add this:
+
+```json
+{
+  "mcpServers": {
+    "late": {
+      "command": "uvx",
+      "args": ["--from", "late-sdk[mcp]", "late-mcp"],
+      "env": {
+        "LATE_API_KEY": "your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+> Get your API key at [getlate.dev/dashboard/api-keys](https://getlate.dev/dashboard/api-keys)
+
+**3. Restart Claude Desktop**
+
+Done! Ask Claude things like:
+- *"Post 'Hello world!' to Twitter"*
+- *"Schedule a LinkedIn post for tomorrow at 9am"*
+- *"Show my connected accounts"*
+
+<details>
+<summary><b>Alternative: Using pip instead of uvx</b></summary>
+
+```bash
+pip install late-sdk[mcp]
+```
+
+```json
+{
+  "mcpServers": {
+    "late": {
+      "command": "python",
+      "args": ["-m", "late.mcp"],
+      "env": {
+        "LATE_API_KEY": "your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+</details>
+
+### Uploading Images/Videos
+
+Since Claude can't access local files, use the browser upload flow:
+
+1. Ask Claude: *"I want to post an image to Instagram"*
+2. Claude gives you an upload link → open it in your browser
+3. Upload your file and tell Claude *"done"*
+4. Claude creates the post with your media
+
+### Available Commands
+
+| Command | What it does |
+|---------|--------------|
+| `list_accounts` | Show connected social accounts |
+| `create_post` | Create scheduled or immediate post |
+| `publish_now` | Publish immediately |
+| `cross_post` | Post to multiple platforms |
+| `list_posts` | Show your posts |
+| `retry_post` | Retry a failed post |
+| `generate_upload_link` | Get link to upload media |
+
+---
+
+## SDK Features
+
+### Async Support
+
+```python
+import asyncio
+from late import Late
+
+async def main():
+    async with Late(api_key="...") as client:
+        posts = await client.posts.alist(status="scheduled")
+
+asyncio.run(main())
+```
+
+### AI Content Generation
+
+```bash
+pip install late-sdk[ai]
+```
+
+```python
+from late.ai import ContentGenerator, GenerateRequest
+
+generator = ContentGenerator(provider="openai", api_key="sk-...")
+
+response = generator.generate(
+    GenerateRequest(
+        prompt="Write a tweet about Python",
+        platform="twitter",
+        tone="casual",
+    )
+)
+
+print(response.text)
+```
+
+### CSV Scheduling
+
+```python
+from late import Late
+from late.pipelines import CSVSchedulerPipeline
+
+client = Late(api_key="...")
+pipeline = CSVSchedulerPipeline(client)
+
+# Validate first
+results = pipeline.schedule("posts.csv", dry_run=True)
+
+# Then schedule
+results = pipeline.schedule("posts.csv")
+```
+
+### Cross-Posting
+
+```python
+from late.pipelines import CrossPosterPipeline, PlatformConfig
+
+cross_poster = CrossPosterPipeline(client)
+
+results = await cross_poster.post(
+    content="Big announcement!",
+    platforms=[
+        PlatformConfig("twitter", "tw_123"),
+        PlatformConfig("linkedin", "li_456", delay_minutes=5),
+    ],
+)
+```
+
+---
+
+## API Reference
+
+### Resources
+
+| Resource | Methods |
+|----------|---------|
+| `client.posts` | `list`, `get`, `create`, `update`, `delete`, `retry` |
+| `client.profiles` | `list`, `get`, `create`, `update`, `delete` |
+| `client.accounts` | `list`, `get` |
+| `client.media` | `upload`, `upload_multiple` |
+| `client.analytics` | `get`, `get_usage` |
+| `client.tools` | `youtube_download`, `instagram_download`, `tiktok_download`, `generate_caption` |
+| `client.queue` | `get_slots`, `preview`, `next_slot` |
+
+### Client Options
+
+```python
+client = Late(
+    api_key="...",
+    timeout=30.0,      # seconds
+    max_retries=3,
+)
+```
+
+---
+
+## Links
+
+- [Late Website](https://getlate.dev)
+- [API Documentation](https://docs.getlate.dev)
+- [Get API Key](https://getlate.dev/dashboard/api-keys)
+
+## License
+
+MIT

late_sdk-1.0.0/claude-desktop-config.json

@@ -0,0 +1,16 @@
+{
+  "mcpServers": {
+    "late": {
+      "command": "uv",
+      "args": [
+        "run",
+        "--directory",
+        "/Users/carlos/Documents/WebDev/Freelance/miquel-palet/late-python-starter",
+        "late-mcp"
+      ],
+      "env": {
+        "LATE_API_KEY": "YOUR_API_KEY_HERE"
+      }
+    }
+  }
+}

late_sdk-1.0.0/examples/01_basic_usage.py

@@ -0,0 +1,61 @@
+"""
+Basic usage example for Late Python SDK.
+
+This example demonstrates:
+- Initializing the client
+- Listing profiles and accounts
+- Creating a scheduled post
+"""
+
+import os
+from datetime import datetime, timedelta
+
+from late import Late
+
+
+def main() -> None:
+    # Initialize client
+    api_key = os.getenv("LATE_API_KEY")
+    if not api_key:
+        print("Set LATE_API_KEY environment variable")
+        return
+
+    client = Late(api_key=api_key)
+
+    # List profiles
+    print("=== Profiles ===")
+    profiles = client.profiles.list()
+    for profile in profiles.get("profiles", []):
+        print(f"  - {profile['name']} (ID: {profile['_id']})")
+
+    # List connected accounts
+    print("\n=== Connected Accounts ===")
+    accounts = client.accounts.list()
+    for account in accounts.get("accounts", []):
+        print(f"  - {account['platform']}: {account.get('username', 'N/A')}")
+
+    # List scheduled posts
+    print("\n=== Scheduled Posts ===")
+    posts = client.posts.list(status="scheduled", limit=5)
+    for post in posts.get("posts", []):
+        print(f"  - {post['content'][:50]}... ({post['status']})")
+
+    # Create a new post (example - uncomment to use)
+    # if accounts.get("accounts"):
+    #     account = accounts["accounts"][0]
+    #     scheduled_time = datetime.now() + timedelta(hours=1)
+    #
+    #     post = client.posts.create(
+    #         content="Hello from Late Python SDK!",
+    #         platforms=[{
+    #             "platform": account["platform"],
+    #             "accountId": account["_id"],
+    #         }],
+    #         scheduled_for=scheduled_time,
+    #         tags=["test", "late-sdk"],
+    #     )
+    #     print(f"\nCreated post: {post['post']['_id']}")
+
+
+if __name__ == "__main__":
+    main()