metaai-sdk 3.0.0__tar.gz → 3.0.1__tar.gz

{metaai_sdk-3.0.0 → metaai_sdk-3.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: metaai-sdk
-Version: 3.0.0
+Version: 3.0.1
 Summary: Feature-rich Python SDK for Meta AI - Chat, Image & Video Generation powered by Llama 3
 Author-email: Ashiq Hussain Mir <imseldrith@gmail.com>
 License-Expression: MIT
@@ -91,18 +91,18 @@ All in one SDK
 
 ### 🌟 Core Capabilities
 
-| Feature                      | Description                                      | Status   |
-| ---------------------------- | ------------------------------------------------ | -------- |
-| 💬 **Intelligent Chat**      | Powered by Llama 3 with internet access          | ✅ Ready |
-| 📤 **Image Upload**          | Upload & analyze images, generate similar images | ✅ Ready |
-| 🎨 **Image Generation**      | Create stunning AI-generated images              | ✅ Ready |
-| 🎬 **Video Generation**      | Generate videos from text or uploaded images     | ✅ Ready |
-| 🔍 **Image Analysis**        | Describe, analyze, and extract info from images  | ✅ Ready |
-| 🌐 **Real-time Data**        | Get current information via Bing integration     | ✅ Ready |
-| 📚 **Source Citations**      | Responses include verifiable sources             | ✅ Ready |
-| 🔄 **Streaming Support**     | Real-time response streaming                     | ✅ Ready |
-| 🔐 **Auto Token Management** | Automatic authentication handling                | ✅ Ready |
-| 🌍 **Proxy Support**         | Route requests through proxies                   | ✅ Ready |
+| Feature                        | Description                                      | Status   |
+| ------------------------------ | ------------------------------------------------ | -------- |
+| 💬 **Intelligent Chat**        | Powered by Llama 3 with internet access          | ✅ Ready |
+| 📤 **Image Upload**            | Upload & analyze images, generate similar images | ✅ Ready |
+| 🎨 **Image Generation**        | Create stunning AI-generated images              | ✅ Ready |
+| 🎬 **Video Generation**        | Generate videos from text or uploaded images     | ✅ Ready |
+| 🔍 **Image Analysis**          | Describe, analyze, and extract info from images  | ✅ Ready |
+| 🌐 **Real-time Data**          | Get current information via Bing integration     | ✅ Ready |
+| 📚 **Source Citations**        | Responses include verifiable sources             | ✅ Ready |
+| 🔄 **Streaming Support**       | Real-time response streaming                     | ✅ Ready |
+| 🔐 **Flexible Authentication** | Auto-fetch or manual token provision             | ✅ Ready |
+| 🌍 **Proxy Support**           | Route requests through proxies                   | ✅ Ready |
 
 ---
 
@@ -217,7 +217,57 @@ This calculation uses the compound interest formula: A = P(1 + r/n)^(nt)
 
 ---
 
-## 💬 Chat Features
+## � Authentication Options
+
+The SDK supports **flexible authentication** with two modes:
+
+### Mode 1: Automatic Token Fetching (Recommended)
+
+Provide basic cookies - `lsd` and `fb_dtsg` tokens are automatically fetched from Meta AI:
+
+```python
+from metaai_api import MetaAI
+
+# Provide basic cookies only
+cookies = {
+    "datr": "your_datr_value",
+    "abra_sess": "your_abra_sess_value",
+    "dpr": "1.25",
+    "wd": "1920x1080"
+}
+
+ai = MetaAI(cookies=cookies)
+# SDK automatically fetches lsd and fb_dtsg tokens!
+```
+
+### Mode 2: Manual Token Provision (Fallback)
+
+Provide all tokens manually if automatic fetching fails:
+
+```python
+from metaai_api import MetaAI
+
+# Provide cookies + manual tokens
+cookies = {
+    "datr": "your_datr_value",
+    "abra_sess": "your_abra_sess_value",
+    "dpr": "1.25",
+    "wd": "1920x1080"
+}
+
+ai = MetaAI(
+    cookies=cookies,
+    lsd="AVq1234567890",           # Manual token
+    fb_dtsg="ABCD:EFGH:123456789"  # Manual token
+)
+# No auto-fetch needed!
+```
+
+> **💡 Tip:** Start with **Mode 1** (automatic). Only use **Mode 2** if you encounter token fetching issues.
+
+---
+
+## �💬 Chat Features
 
 ### Streaming Responses
 
@@ -389,6 +439,11 @@ Create AI-generated videos from text descriptions!
 4. Click any request → **Headers** → Copy **Cookie** value
 5. Extract these values: `datr`, `abra_sess`, `dpr`, `wd`
 
+> **💡 Note:** The SDK supports **two authentication modes**:
+>
+> - **Automatic** (Recommended): Provide basic cookies, `lsd` and `fb_dtsg` tokens are auto-fetched
+> - **Manual**: Optionally provide `lsd` and `fb_dtsg` tokens directly if automatic fetching fails
+
 ### Example 1: Generate Your First Video
 
 ```python
@@ -442,6 +497,44 @@ else:
 🆔 Conversation ID: abc123-def456-ghi789
 ```
 
+### Example 1b: Manual Token Provision (Optional)
+
+If automatic token fetching fails or you prefer to provide tokens directly:
+
+```python
+from metaai_api import MetaAI
+
+# Your browser cookies + manually extracted tokens
+cookies = {
+    "datr": "your_datr_value_here",
+    "abra_sess": "your_abra_sess_value_here",
+    "dpr": "1.25",
+    "wd": "1920x1080"
+}
+
+# Initialize with manual tokens (no auto-fetch needed)
+ai = MetaAI(
+    cookies=cookies,
+    lsd="AVq1234567890",              # Manually extracted lsd token
+    fb_dtsg="ABCD:EFGH:123456789"     # Manually extracted fb_dtsg token
+)
+
+# Generate a video - tokens are already provided!
+result = ai.generate_video("A peaceful zen garden with koi fish")
+
+if result["success"]:
+    print("✅ Video generated successfully with manual tokens!")
+    print(f"🎬 Video URL: {result['video_urls'][0]}")
+```
+
+**How to extract `lsd` and `fb_dtsg` tokens:**
+
+1. Open https://meta.ai in your browser (logged in)
+2. Press **F12** → **Console** tab
+3. Run: `document.cookie`
+4. Look for `lsd=...` and `fb_dtsg=...` values
+5. Alternatively, right-click → **View Page Source** → Search for `"LSD",[],{"token":"` and `DTSGInitData",[],{"token":"`
+
 ### Example 2: Generate Multiple Videos
 
 ```python

{metaai_sdk-3.0.0 → metaai_sdk-3.0.1}/README.md

@@ -51,18 +51,18 @@ All in one SDK
 
 ### 🌟 Core Capabilities
 
-| Feature                      | Description                                      | Status   |
-| ---------------------------- | ------------------------------------------------ | -------- |
-| 💬 **Intelligent Chat**      | Powered by Llama 3 with internet access          | ✅ Ready |
-| 📤 **Image Upload**          | Upload & analyze images, generate similar images | ✅ Ready |
-| 🎨 **Image Generation**      | Create stunning AI-generated images              | ✅ Ready |
-| 🎬 **Video Generation**      | Generate videos from text or uploaded images     | ✅ Ready |
-| 🔍 **Image Analysis**        | Describe, analyze, and extract info from images  | ✅ Ready |
-| 🌐 **Real-time Data**        | Get current information via Bing integration     | ✅ Ready |
-| 📚 **Source Citations**      | Responses include verifiable sources             | ✅ Ready |
-| 🔄 **Streaming Support**     | Real-time response streaming                     | ✅ Ready |
-| 🔐 **Auto Token Management** | Automatic authentication handling                | ✅ Ready |
-| 🌍 **Proxy Support**         | Route requests through proxies                   | ✅ Ready |
+| Feature                        | Description                                      | Status   |
+| ------------------------------ | ------------------------------------------------ | -------- |
+| 💬 **Intelligent Chat**        | Powered by Llama 3 with internet access          | ✅ Ready |
+| 📤 **Image Upload**            | Upload & analyze images, generate similar images | ✅ Ready |
+| 🎨 **Image Generation**        | Create stunning AI-generated images              | ✅ Ready |
+| 🎬 **Video Generation**        | Generate videos from text or uploaded images     | ✅ Ready |
+| 🔍 **Image Analysis**          | Describe, analyze, and extract info from images  | ✅ Ready |
+| 🌐 **Real-time Data**          | Get current information via Bing integration     | ✅ Ready |
+| 📚 **Source Citations**        | Responses include verifiable sources             | ✅ Ready |
+| 🔄 **Streaming Support**       | Real-time response streaming                     | ✅ Ready |
+| 🔐 **Flexible Authentication** | Auto-fetch or manual token provision             | ✅ Ready |
+| 🌍 **Proxy Support**           | Route requests through proxies                   | ✅ Ready |
 
 ---
 
@@ -177,7 +177,57 @@ This calculation uses the compound interest formula: A = P(1 + r/n)^(nt)
 
 ---
 
-## 💬 Chat Features
+## � Authentication Options
+
+The SDK supports **flexible authentication** with two modes:
+
+### Mode 1: Automatic Token Fetching (Recommended)
+
+Provide basic cookies - `lsd` and `fb_dtsg` tokens are automatically fetched from Meta AI:
+
+```python
+from metaai_api import MetaAI
+
+# Provide basic cookies only
+cookies = {
+    "datr": "your_datr_value",
+    "abra_sess": "your_abra_sess_value",
+    "dpr": "1.25",
+    "wd": "1920x1080"
+}
+
+ai = MetaAI(cookies=cookies)
+# SDK automatically fetches lsd and fb_dtsg tokens!
+```
+
+### Mode 2: Manual Token Provision (Fallback)
+
+Provide all tokens manually if automatic fetching fails:
+
+```python
+from metaai_api import MetaAI
+
+# Provide cookies + manual tokens
+cookies = {
+    "datr": "your_datr_value",
+    "abra_sess": "your_abra_sess_value",
+    "dpr": "1.25",
+    "wd": "1920x1080"
+}
+
+ai = MetaAI(
+    cookies=cookies,
+    lsd="AVq1234567890",           # Manual token
+    fb_dtsg="ABCD:EFGH:123456789"  # Manual token
+)
+# No auto-fetch needed!
+```
+
+> **💡 Tip:** Start with **Mode 1** (automatic). Only use **Mode 2** if you encounter token fetching issues.
+
+---
+
+## �💬 Chat Features
 
 ### Streaming Responses
 
@@ -349,6 +399,11 @@ Create AI-generated videos from text descriptions!
 4. Click any request → **Headers** → Copy **Cookie** value
 5. Extract these values: `datr`, `abra_sess`, `dpr`, `wd`
 
+> **💡 Note:** The SDK supports **two authentication modes**:
+>
+> - **Automatic** (Recommended): Provide basic cookies, `lsd` and `fb_dtsg` tokens are auto-fetched
+> - **Manual**: Optionally provide `lsd` and `fb_dtsg` tokens directly if automatic fetching fails
+
 ### Example 1: Generate Your First Video
 
 ```python
@@ -402,6 +457,44 @@ else:
 🆔 Conversation ID: abc123-def456-ghi789
 ```
 
+### Example 1b: Manual Token Provision (Optional)
+
+If automatic token fetching fails or you prefer to provide tokens directly:
+
+```python
+from metaai_api import MetaAI
+
+# Your browser cookies + manually extracted tokens
+cookies = {
+    "datr": "your_datr_value_here",
+    "abra_sess": "your_abra_sess_value_here",
+    "dpr": "1.25",
+    "wd": "1920x1080"
+}
+
+# Initialize with manual tokens (no auto-fetch needed)
+ai = MetaAI(
+    cookies=cookies,
+    lsd="AVq1234567890",              # Manually extracted lsd token
+    fb_dtsg="ABCD:EFGH:123456789"     # Manually extracted fb_dtsg token
+)
+
+# Generate a video - tokens are already provided!
+result = ai.generate_video("A peaceful zen garden with koi fish")
+
+if result["success"]:
+    print("✅ Video generated successfully with manual tokens!")
+    print(f"🎬 Video URL: {result['video_urls'][0]}")
+```
+
+**How to extract `lsd` and `fb_dtsg` tokens:**
+
+1. Open https://meta.ai in your browser (logged in)
+2. Press **F12** → **Console** tab
+3. Run: `document.cookie`
+4. Look for `lsd=...` and `fb_dtsg=...` values
+5. Alternatively, right-click → **View Page Source** → Search for `"LSD",[],{"token":"` and `DTSGInitData",[],{"token":"`
+
 ### Example 2: Generate Multiple Videos
 
 ```python

metaai_sdk-3.0.1/examples/manual_token_example.py

@@ -0,0 +1,169 @@
+"""
+Example: Using Meta AI API with Manual Token Provision
+
+This example demonstrates how to use the Meta AI API when encountering
+challenge page issues. You can manually extract and provide tokens to
+bypass the automatic token fetching.
+"""
+
+from typing import Dict
+from metaai_api import MetaAI
+
+# ============================================================================
+# Option 1: Let the library handle challenge pages automatically
+# ============================================================================
+print("Option 1: Automatic challenge handling\n" + "="*50)
+
+# Provide your cookies (extracted from browser)
+cookies = {
+    "datr": "your_datr_cookie",
+    "abra_sess": "your_abra_sess_cookie",
+    "dpr": "1.25",
+    "wd": "1536x730",
+    "abra_csrf": "your_abra_csrf_cookie"
+}
+
+# The library will automatically handle challenge pages and fetch tokens
+ai = MetaAI(cookies=cookies)
+
+# If successful, you can now use the API
+# Note: stream=False returns a Dict, stream=True returns a Generator
+response: Dict = ai.prompt("Hello, Meta AI!", stream=False)  # type: ignore
+print(f"Response: {response['message']}\n")
+
+
+# ============================================================================
+# Option 2: Manually provide lsd and fb_dtsg tokens
+# ============================================================================
+print("\nOption 2: Manual token provision\n" + "="*50)
+
+# If automatic fetching fails, you can manually extract tokens from browser
+# and provide them directly:
+
+# 1. Open https://www.meta.ai in your browser
+# 2. Open Developer Tools (F12)
+# 3. Go to Console tab
+# 4. Type: document.cookie
+# 5. Extract lsd token from the page source:
+#    - View page source (Ctrl+U)
+#    - Search for: "LSD",[],{"token":"
+#    - Copy the token value
+# 6. Extract fb_dtsg token:
+#    - Search for: DTSGInitData",[],{"token":"
+#    - Copy the token value
+
+cookies_with_manual_tokens = {
+    "datr": "your_datr_cookie",
+    "abra_sess": "your_abra_sess_cookie", 
+    "dpr": "1.25",
+    "wd": "1536x730",
+    "abra_csrf": "your_abra_csrf_cookie"
+}
+
+# Provide tokens explicitly
+ai_manual = MetaAI(
+    cookies=cookies_with_manual_tokens,
+    lsd="your_manually_extracted_lsd_token",
+    fb_dtsg="your_manually_extracted_fb_dtsg_token"
+)
+
+response: Dict = ai_manual.prompt("What can you help me with?", stream=False)  # type: ignore
+print(f"Response: {response['message']}\n")
+
+
+# ============================================================================
+# Option 3: Using with Facebook login (auto-handles challenges)
+# ============================================================================
+print("\nOption 3: Facebook login with auto-challenge handling\n" + "="*50)
+
+# If you have Facebook credentials, the library will authenticate
+# and automatically handle any challenge pages
+ai_fb = MetaAI(
+    fb_email="your_email@example.com",
+    fb_password="your_password"
+)
+
+response: Dict = ai_fb.prompt("Tell me a fun fact", stream=False)  # type: ignore
+print(f"Response: {response['message']}\n")
+
+
+# ============================================================================
+# Extracting tokens from browser (detailed guide)
+# ============================================================================
+print("\n" + "="*50)
+print("HOW TO EXTRACT TOKENS FROM BROWSER")
+print("="*50)
+print("""
+1. Open https://www.meta.ai in your browser and log in
+
+2. Extract cookies:
+   - Press F12 to open Developer Tools
+   - Go to Application/Storage tab
+   - Click on Cookies > https://www.meta.ai
+   - Copy these cookie values:
+     * datr
+     * abra_sess
+     * dpr
+     * wd
+     * abra_csrf
+
+3. Extract lsd token:
+   - Right-click on page and select "View Page Source" (Ctrl+U)
+   - Press Ctrl+F and search for: "LSD",[],{"token":"
+   - Copy the value between the quotes
+   - Example: "LSD",[],{"token":"AVq1234567890"}
+             Copy: AVq1234567890
+
+4. Extract fb_dtsg token:
+   - In the same page source, search for: DTSGInitData",[],{"token":"
+   - Copy the value between the quotes
+   - Example: DTSGInitData",[],{"token":"ABCD:EFGH:1234567890"}
+             Copy: ABCD:EFGH:1234567890
+
+5. Use the extracted values in your code:
+
+   cookies = {
+       "datr": "<your_datr>",
+       "abra_sess": "<your_abra_sess>",
+       "dpr": "1.25",
+       "wd": "1536x730",
+       "abra_csrf": "<your_abra_csrf>"
+   }
+   
+   ai = MetaAI(
+       cookies=cookies,
+       lsd="<your_lsd_token>",
+       fb_dtsg="<your_fb_dtsg_token>"
+   )
+
+Note: Tokens may expire after some time. If you get errors, extract fresh tokens.
+""")
+
+
+# ============================================================================
+# Troubleshooting
+# ============================================================================
+print("\n" + "="*50)
+print("TROUBLESHOOTING")
+print("="*50)
+print("""
+If you encounter errors:
+
+1. Enable logging to see detailed information:
+   
+   import logging
+   logging.basicConfig(level=logging.INFO)
+
+2. Check if challenge handling is working:
+   - Look for log messages about "Meta AI challenge page"
+   - The library will automatically retry with challenge handling
+
+3. Try manual token provision if automatic fetching fails
+
+4. Ensure your cookies are fresh (extracted within the last few hours)
+
+5. If using a proxy, make sure it's working correctly
+
+6. Try accessing https://www.meta.ai directly in your browser
+   to ensure you're not blocked or rate-limited
+""")

{metaai_sdk-3.0.0 → metaai_sdk-3.0.1}/examples/simple_example.py

@@ -1,6 +1,8 @@
 from metaai_api import MetaAI
 
-# Your cookies from browser (lsd and fb_dtsg are auto-fetched!)
+# Your cookies from browser - lsd and fb_dtsg are automatically fetched!
+# Note: If you encounter challenges, you can also provide tokens manually:
+#   ai = MetaAI(cookies=cookies, lsd="your_lsd_token", fb_dtsg="your_fb_dtsg_token")
 cookies = {
     "datr": "datrcookie",
     "abra_sess": "abrasessioncookie",
@@ -22,7 +24,7 @@ print("="*80)
 # Use for chat
 print("\nAsking: What's the weather in San Francisco?")
 try:
-    chat = ai.prompt("What's the weather in San Francisco?", stream=False)
+    chat: dict = ai.prompt("What's the weather in San Francisco?", stream=False)  # type: ignore
     print(f"\n✅ Chat Response:\n{chat['message'][:200]}...\n")
 except Exception as e:
     print(f"❌ Chat Error: {e}\n")