Skip to main content

Feature-rich Python SDK for Meta AI - Chat, Image & Video Generation powered by Llama 3

Project description

๐Ÿค– Meta AI Python SDK

Python Version License PyPI GitHub

Unleash the Power of Meta AI with Python ๐Ÿš€

A modern, feature-rich Python SDK providing seamless access to Meta AI's cutting-edge capabilities: Chat with Llama 3, Generate Images, Create AI Videos - All Without API Keys!

๐ŸŽฏ Quick Start โ€ข ๐Ÿ“– Documentation โ€ข ๐Ÿ’ก Examples โ€ข ๐ŸŽฌ Video Generation


โœจ Why Choose This SDK?

๐ŸŽฏ Zero Configuration

No API keys needed! Just install and start coding

โšก Lightning Fast

Optimized for performance Real-time responses

๐Ÿ”ฅ Feature Complete

Chat โ€ข Images โ€ข Videos 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
๐Ÿ” Flexible Authentication Auto-fetch or manual token provision โœ… Ready
๐ŸŒ Proxy Support Route requests through proxies โœ… Ready

๐Ÿ“ฆ Installation

SDK Only (Lightweight)

For using Meta AI as a Python library:

pip install metaai-sdk

SDK + API Server

For deploying as a REST API service:

pip install metaai-sdk[api]

From Source

git clone https://github.com/mir-ashiq/metaai-api.git
cd metaai-api
pip install -e .          # SDK only
pip install -e ".[api]"   # SDK + API server

System Requirements: Python 3.7+ โ€ข Internet Connection โ€ข That's it!


๐Ÿš€ Quick Start

Example 1: Ask a Question

from metaai_api import MetaAI

# Initialize the AI
ai = MetaAI()

# Ask anything!
response = ai.prompt("Who won the NBA championship in 2024?")
print(response["message"])

Output:

The Boston Celtics won the 2024 NBA Championship, defeating the Dallas Mavericks
4-1 in the Finals. Jayson Tatum and Jaylen Brown led the Celtics to their 18th
championship title, the most in NBA history. The series concluded on June 17, 2024,
with the Celtics winning Game 5 at TD Garden in Boston.

Example 2: Get Stock Market Info

from metaai_api import MetaAI

ai = MetaAI()
response = ai.prompt("What is the current price of Bitcoin?")

print(f"๐Ÿ’ฐ {response['message']}")
print(f"\n๐Ÿ“š Sources: {len(response['sources'])} references found")

Output:

๐Ÿ’ฐ As of November 22, 2025, Bitcoin (BTC) is trading at approximately $97,845 USD.
The cryptocurrency has seen a 3.2% increase in the last 24 hours. Bitcoin's market
capitalization stands at around $1.93 trillion, maintaining its position as the
largest cryptocurrency by market cap.

๐Ÿ“š Sources: 4 references found

Example 3: Solve Math Problems

from metaai_api import MetaAI

ai = MetaAI()

# Complex calculation
question = "If I invest $10,000 at 7% annual interest compounded monthly for 5 years, how much will I have?"
response = ai.prompt(question)

print(response["message"])

Output:

With an initial investment of $10,000 at a 7% annual interest rate compounded monthly
over 5 years, you would have approximately $14,176.25.

Here's the breakdown:
- Principal: $10,000
- Interest Rate: 7% per year (0.583% per month)
- Time: 5 years (60 months)
- Compound Frequency: Monthly
- Total Interest Earned: $4,176.25
- Final Amount: $14,176.25

This calculation uses the compound interest formula: A = P(1 + r/n)^(nt)

๏ฟฝ 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:

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:

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

Watch responses appear in real-time, like ChatGPT:

from metaai_api import MetaAI

ai = MetaAI()

print("๐Ÿค– AI: ", end="", flush=True)
for chunk in ai.prompt("Explain quantum computing in simple terms", stream=True):
    print(chunk["message"], end="", flush=True)
print("\n")

Output:

๐Ÿค– AI: Quantum computing is like having a super-powered calculator that can solve
problems in completely new ways. Instead of regular computer bits that are either
0 or 1, quantum computers use "qubits" that can be both 0 and 1 at the same time -
imagine flipping a coin that's both heads and tails until you look at it! This
special ability allows quantum computers to process massive amounts of information
simultaneously, making them incredibly fast for specific tasks like drug discovery,
cryptography, and complex simulations.

Conversation Context

Have natural back-and-forth conversations:

from metaai_api import MetaAI

ai = MetaAI()

# First question
response1 = ai.prompt("What are the three primary colors?")
print("Q1:", response1["message"][:100])

# Follow-up question (maintains context)
response2 = ai.prompt("How do you mix them to make purple?")
print("Q2:", response2["message"][:150])

# Start fresh conversation
response3 = ai.prompt("What's the capital of France?", new_conversation=True)
print("Q3:", response3["message"][:50])

Output:

Q1: The three primary colors are Red, Blue, and Yellow. These colors cannot be created by mixing...

Q2: To make purple, you mix Red and Blue together. The exact shade of purple depends on the ratio - more red creates a reddish-purple (like magenta)...

Q3: The capital of France is Paris, located in the...

Using Proxies

Route your requests through a proxy:

from metaai_api import MetaAI

# Configure proxy
proxy = {
    'http': 'http://your-proxy-server:8080',
    'https': 'https://your-proxy-server:8080'
}

ai = MetaAI(proxy=proxy)
response = ai.prompt("Hello from behind a proxy!")
print(response["message"])

๏ฟฝ REST API Server (Optional)

Deploy Meta AI as a REST API service that anyone can use! The API server auto-refreshes cookies to keep sessions alive.

Installation

pip install metaai-sdk[api]

Setup

  1. Get your Meta AI cookies (see Video Generation section)
  2. Create .env file:
META_AI_DATR=your_datr_cookie
META_AI_ABRA_SESS=your_abra_sess_cookie
META_AI_DPR=1
META_AI_WD=1920x1080
META_AI_REFRESH_INTERVAL_SECONDS=3600
  1. Start the server:
uvicorn metaai_api.api_server:app --host 0.0.0.0 --port 8000

API Endpoints

Endpoint Method Description
/upload POST Upload images for analysis/generation
/chat POST Send chat messages (with/without imgs)
/image POST Generate images (from text or imgs)
/video POST Generate video (blocks until complete)
/video/async POST Start async video generation
/video/jobs/{job_id} GET Poll async job status
/healthz GET Health check

Example Usage

import requests

# Chat
response = requests.post("http://localhost:8000/chat", json={
    "message": "What is the capital of France?",
    "stream": False
})
print(response.json())

# Image generation
images = requests.post("http://localhost:8000/image", json={
    "prompt": "Cyberpunk cityscape at night",
    "new_conversation": False
})
print(images.json())

# Async video generation
job = requests.post("http://localhost:8000/video/async", json={
    "prompt": "Generate a video of a sunset"
})
job_id = job.json()["job_id"]

# Poll for result
status = requests.get(f"http://localhost:8000/video/jobs/{job_id}")
print(status.json())

Testing

python test_api.py

๏ฟฝ๐ŸŽฌ Video Generation

Create AI-generated videos from text descriptions!

Setup: Get Your Cookies

  1. Visit meta.ai in your browser
  2. Open DevTools (F12) โ†’ Network tab
  3. Refresh the page
  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

from metaai_api import MetaAI

# Your browser cookies
cookies = {
    "datr": "your_datr_value_here",
    "abra_sess": "your_abra_sess_value_here",
    "dpr": "1.25",
    "wd": "1920x1080"
}

# Initialize with cookies
ai = MetaAI(cookies=cookies)

# Generate a video
result = ai.generate_video("A majestic lion walking through the African savanna at sunset")

if result["success"]:
    print("โœ… Video generated successfully!")
    print(f"๐ŸŽฌ Generated {len(result['video_urls'])} videos (Meta AI creates 4 by default)")
    for i, url in enumerate(result['video_urls'], 1):
        print(f"   Video {i}: {url}")
    print(f"๐Ÿ“ Prompt: {result['prompt']}")
    print(f"๐Ÿ†” Conversation ID: {result['conversation_id']}")
else:
    print("โณ Video is still processing, try again in a moment")

Output:

[*] Fetching missing tokens (lsd, fb_dtsg) from Meta AI...
[โœ“] Fetched lsd: AVrvi8aHxzQ
[โœ“] Fetched fb_dtsg: BQAB9uRXmPEYGkC...

โœ… Sending video generation request...
โœ… Video generation request sent successfully!
โณ Waiting 10 seconds before polling...
๐Ÿ”„ Polling for video URLs (Attempt 1/30)...
โœ… Video URLs found!

โœ… Video generated successfully!
๐ŸŽฌ Generated 4 videos (Meta AI creates 4 by default)
   Video 1: https://scontent.xx.fbcdn.net/v/t66.36240-6/video1.mp4?...
   Video 2: https://scontent.xx.fbcdn.net/v/t66.36240-6/video2.mp4?...
   Video 3: https://scontent.xx.fbcdn.net/v/t66.36240-6/video3.mp4?...
   Video 4: https://scontent.xx.fbcdn.net/v/t66.36240-6/video4.mp4?...
๐Ÿ“ Prompt: A majestic lion walking through the African savanna at sunset
๐Ÿ†” Conversation ID: abc123-def456-ghi789

Example 1b: Manual Token Provision (Optional)

If automatic token fetching fails or you prefer to provide tokens directly:

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

from metaai_api import MetaAI
import time

ai = MetaAI(cookies=cookies)

prompts = [
    "A futuristic city with flying cars at night",
    "Ocean waves crashing on a tropical beach",
    "Northern lights dancing over a snowy mountain"
]

videos = []
for i, prompt in enumerate(prompts, 1):
    print(f"\n๐ŸŽฌ Generating video {i}/{len(prompts)}: {prompt}")
    result = ai.generate_video(prompt, verbose=False)

    if result["success"]:
        videos.append(result["video_urls"][0])
        print(f"โœ… Success! URL: {result['video_urls'][0][:50]}...")
    else:
        print("โณ Still processing...")

    time.sleep(5)  # Be nice to the API

print(f"\n๐ŸŽ‰ Generated {len(videos)} videos successfully!")

Output:

๐ŸŽฌ Generating video 1/3: A futuristic city with flying cars at night
โœ… Success! URL: https://scontent.xx.fbcdn.net/v/t66.36240-6/1234...

๐ŸŽฌ Generating video 2/3: Ocean waves crashing on a tropical beach
โœ… Success! URL: https://scontent.xx.fbcdn.net/v/t66.36240-6/5678...

๐ŸŽฌ Generating video 3/3: Northern lights dancing over a snowy mountain
โœ… Success! URL: https://scontent.xx.fbcdn.net/v/t66.36240-6/9012...

๐ŸŽ‰ Generated 3 videos successfully!

Example 3: Advanced Video Generation with Orientation

from metaai_api import MetaAI

ai = MetaAI(cookies=cookies)

# Generate video with specific orientation (default is VERTICAL)
result = ai.generate_video(
    prompt="A time-lapse of a flower blooming",
    orientation="VERTICAL",   # Options: "LANDSCAPE", "VERTICAL", "SQUARE"
    wait_before_poll=15,      # Wait 15 seconds before checking
    max_attempts=50,          # Try up to 50 times
    wait_seconds=3,           # Wait 3 seconds between attempts
    verbose=True              # Show detailed progress
)

# Generate landscape video for widescreen
result_landscape = ai.generate_video(
    prompt="Panoramic view of sunset over mountains",
    orientation="LANDSCAPE"   # Wide format (16:9)
)

if result["success"]:
    print(f"\n๐ŸŽฌ Your videos are ready!")
    print(f"๐Ÿ”— Generated {len(result['video_urls'])} videos:")
    for i, url in enumerate(result['video_urls'], 1):
        print(f"   Video {i}: {url}")
    print(f"โฑ๏ธ Generated at: {result['timestamp']}")

Supported Video Orientations:

  • "LANDSCAPE" - Wide/horizontal (16:9) - ideal for widescreen, cinematic content
  • "VERTICAL" - Tall/vertical (9:16) - ideal for mobile, stories, reels (default)
  • "SQUARE" - Equal dimensions (1:1) - ideal for social posts

๐Ÿ“– **Full Video Guide:** See [VIDEO_GENERATION_README.md](https://github.com/mir-ashiq/metaai-api/blob/main/VIDEO_GENERATION_README.md) for complete documentation!

---

## ๐Ÿ“ค Image Upload & Analysis

Upload images to Meta AI for analysis, similar image generation, and video creation:

### Upload & Analyze Images

```python
from metaai_api import MetaAI

# Initialize with Facebook cookies (required for image operations)
ai = MetaAI(cookies={
    "datr": "your_datr_cookie",
    "abra_sess": "your_abra_sess_cookie"
})

# Step 1: Upload an image
result = ai.upload_image("path/to/image.jpg")

if result["success"]:
    media_id = result["media_id"]
    metadata = {
        'file_size': result['file_size'],
        'mime_type': result['mime_type']
    }

    # Step 2: Analyze the image
    response = ai.prompt(
        message="What do you see in this image? Describe it in detail.",
        media_ids=[media_id],
        attachment_metadata=metadata
    )
    print(f"๐Ÿ” Analysis: {response['message']}")

    # Step 3: Generate similar images
    response = ai.prompt(
        message="Create a similar image in watercolor painting style",
        media_ids=[media_id],
        attachment_metadata=metadata,
        is_image_generation=True
    )
    print(f"๐ŸŽจ Generated {len(response['media'])} similar images")

    # Step 4: Generate video from image
    video = ai.generate_video(
        prompt="generate a video with zoom in effect on this image",
        media_ids=[media_id],
        attachment_metadata=metadata
    )
    if video["success"]:
        print(f"๐ŸŽฌ Video: {video['video_urls'][0]}")

Output:

๐Ÿ” Analysis: The image captures a serene lake scene set against a majestic mountain backdrop. In the foreground, there's a small, golden-yellow wooden boat with a bright yellow canopy floating on calm, glassโ€‘like water...

๐ŸŽจ Generated 4 similar images

๐ŸŽฌ Video: https://scontent.fsxr1-2.fna.fbcdn.net/o1/v/t6/f2/m421/video.mp4

๐Ÿ“– Full Image Upload Guide: See IMAGE_UPLOAD_README.md for complete documentation!


๐ŸŽจ Image Generation

Generate AI-powered images with customizable orientations (requires Facebook authentication):

from metaai_api import MetaAI

# Initialize with Facebook credentials
ai = MetaAI(fb_email="your_email@example.com", fb_password="your_password")

# Generate images with default orientation (VERTICAL)
response = ai.prompt("Generate an image of a cyberpunk cityscape at night with neon lights")

# Or specify orientation explicitly
response_landscape = ai.prompt(
    "Generate an image of a panoramic mountain landscape",
    orientation="LANDSCAPE"  # Options: "LANDSCAPE", "VERTICAL", "SQUARE"
)

response_vertical = ai.prompt(
    "Generate an image of a tall waterfall",
    orientation="VERTICAL"  # Tall/portrait format (default)
)

response_square = ai.prompt(
    "Generate an image of a centered mandala pattern",
    orientation="SQUARE"  # Square format (1:1)
)

# Display results (Meta AI generates 4 images by default)
print(f"๐ŸŽจ Generated {len(response['media'])} images:")
for i, image in enumerate(response['media'], 1):
    print(f"  Image {i}: {image['url']}")
    print(f"  Prompt: {image['prompt']}")

Supported Orientations:

  • "LANDSCAPE" - Wide/horizontal format (16:9) - ideal for panoramas, landscapes
  • "VERTICAL" - Tall/vertical format (9:16) - ideal for portraits, mobile content (default)
  • "SQUARE" - Equal dimensions (1:1) - ideal for social media, profile images

Output:

๐ŸŽจ Generated 4 images:
  Image 1: https://scontent.xx.fbcdn.net/o1/v/t0/f1/m247/img1.jpeg
  Prompt: a cyberpunk cityscape at night with neon lights

  Image 2: https://scontent.xx.fbcdn.net/o1/v/t0/f1/m247/img2.jpeg
  Prompt: a cyberpunk cityscape at night with neon lights

  Image 3: https://scontent.xx.fbcdn.net/o1/v/t0/f1/m247/img3.jpeg
  Prompt: a cyberpunk cityscape at night with neon lights

  Image 4: https://scontent.xx.fbcdn.net/o1/v/t0/f1/m247/img4.jpeg
  Prompt: a cyberpunk cityscape at night with neon lights

๐Ÿ’ก Examples

Explore working examples in the examples/ directory:

File Description Features
๐Ÿ“„ image_workflow_complete.py Complete image workflow Upload, analyze, generate images/video
๐Ÿ“„ simple_example.py Quick start guide Basic chat + video generation
๐Ÿ“„ video_generation.py Video generation Multiple examples, error handling
๐Ÿ“„ test_example.py Testing suite Validation and testing

Run an Example

# Clone the repository
git clone https://github.com/mir-ashiq/metaai-api.git
cd meta-ai-python

# Run simple example
python examples/simple_example.py

# Run video generation examples
python examples/video_generation.py

๐Ÿ“– Documentation

๐Ÿ“š Complete Guides

Document Description
๐Ÿ“˜ Image Upload Guide Complete image upload documentation
๐Ÿ“˜ Video Generation Guide Complete video generation documentation
๐Ÿ“™ Quick Reference Fast lookup for common tasks
๐Ÿ“™ Quick Usage Image upload quick reference
๐Ÿ“— Architecture Guide Technical architecture details
๐Ÿ“• Contributing Guide How to contribute to the project
๐Ÿ“” Changelog Version history and updates
๐Ÿ““ Security Policy Security best practices

๐Ÿ”ง API Reference

MetaAI Class

class MetaAI:
    def __init__(
        self,
        fb_email: Optional[str] = None,
        fb_password: Optional[str] = None,
        cookies: Optional[dict] = None,
        proxy: Optional[dict] = None
    )

Methods:

  • prompt(message, stream=False, new_conversation=False)

    • Send a chat message
    • Returns: dict with message, sources, and media
  • generate_video(prompt, wait_before_poll=10, max_attempts=30, wait_seconds=5, verbose=True)

    • Generate a video from text
    • Returns: dict with success, video_urls, conversation_id, prompt, timestamp

VideoGenerator Class

from metaai_api import VideoGenerator

# Direct video generation
generator = VideoGenerator(cookies_str="your_cookies_as_string")
result = generator.generate_video("your prompt here")

# One-liner generation
result = VideoGenerator.quick_generate(
    cookies_str="your_cookies",
    prompt="your prompt"
)

๐ŸŽฏ Use Cases

1. Research Assistant

ai = MetaAI()
research = ai.prompt("Summarize recent breakthroughs in fusion energy")
print(research["message"])
# Get cited sources
for source in research["sources"]:
    print(f"๐Ÿ“Œ {source['title']}: {source['link']}")

2. Content Creation

ai = MetaAI(cookies=cookies)

# Generate video content
promo_video = ai.generate_video("Product showcase with smooth camera movements")

# Generate images
thumbnails = ai.prompt("Generate a YouTube thumbnail for a tech review video")

3. Educational Tool

ai = MetaAI()

# Explain complex topics
explanation = ai.prompt("Explain blockchain technology to a 10-year-old")

# Get homework help
solution = ai.prompt("Solve: 2x + 5 = 13, show steps")

4. Real-time Information

ai = MetaAI()

# Current events
news = ai.prompt("What are the top technology news today?")

# Sports scores
scores = ai.prompt("Latest Premier League scores")

# Market data
stocks = ai.prompt("Current S&P 500 index value")

๐Ÿ› ๏ธ Advanced Configuration

Environment Variables

Store credentials securely:

# .env file
META_AI_DATR=your_datr_value
META_AI_ABRA_SESS=your_abra_sess_value
META_AI_DPR=1.25
META_AI_WD=1920x1080

Load in Python:

import os
from dotenv import load_dotenv
from metaai_api import MetaAI

load_dotenv()

cookies = {
    "datr": os.getenv("META_AI_DATR"),
    "abra_sess": os.getenv("META_AI_ABRA_SESS"),
    "dpr": os.getenv("META_AI_DPR"),
    "wd": os.getenv("META_AI_WD")
}

ai = MetaAI(cookies=cookies)

Error Handling

from metaai_api import MetaAI

ai = MetaAI(cookies=cookies)

try:
    result = ai.generate_video("Your prompt")

    if result["success"]:
        print(f"โœ… Video: {result['video_urls'][0]}")
    else:
        print("โณ Video still processing, try again later")

except ValueError as e:
    print(f"โŒ Configuration error: {e}")
except ConnectionError as e:
    print(f"โŒ Network error: {e}")
except Exception as e:
    print(f"โŒ Unexpected error: {e}")

๐ŸŒŸ Project Structure

meta-ai-python/
โ”‚
โ”œโ”€โ”€ ๐Ÿ“ src/metaai_api/        # Core package
โ”‚   โ”œโ”€โ”€ __init__.py            # Package initialization
โ”‚   โ”œโ”€โ”€ main.py                # MetaAI class
โ”‚   โ”œโ”€โ”€ video_generation.py    # Video generation
โ”‚   โ”œโ”€โ”€ client.py              # Client utilities
โ”‚   โ”œโ”€โ”€ utils.py               # Helper functions
โ”‚   โ””โ”€โ”€ exceptions.py          # Custom exceptions
โ”‚
โ”œโ”€โ”€ ๐Ÿ“ examples/               # Usage examples
โ”‚   โ”œโ”€โ”€ simple_example.py      # Quick start
โ”‚   โ”œโ”€โ”€ video_generation.py    # Video examples
โ”‚   โ””โ”€โ”€ test_example.py        # Testing
โ”‚
โ”œโ”€โ”€ ๐Ÿ“ .github/                # GitHub configuration
โ”‚   โ”œโ”€โ”€ workflows/             # CI/CD pipelines
โ”‚   โ””โ”€โ”€ README.md
โ”‚
โ”œโ”€โ”€ ๐Ÿ“„ README.md               # This file
โ”œโ”€โ”€ ๐Ÿ“„ VIDEO_GENERATION_README.md
โ”œโ”€โ”€ ๐Ÿ“„ QUICK_REFERENCE.md
โ”œโ”€โ”€ ๐Ÿ“„ ARCHITECTURE.md
โ”œโ”€โ”€ ๐Ÿ“„ CONTRIBUTING.md
โ”œโ”€โ”€ ๐Ÿ“„ CHANGELOG.md
โ”œโ”€โ”€ ๐Ÿ“„ SECURITY.md
โ”œโ”€โ”€ ๐Ÿ“„ LICENSE                 # MIT License
โ”œโ”€โ”€ ๐Ÿ“„ setup.py                # Package setup
โ”œโ”€โ”€ ๐Ÿ“„ pyproject.toml          # Project metadata
โ””โ”€โ”€ ๐Ÿ“„ requirements.txt        # Dependencies

๐Ÿค Contributing

We welcome contributions! Here's how you can help:

  1. ๐Ÿ› Report Bugs - Open an issue
  2. ๐Ÿ’ก Suggest Features - Share your ideas
  3. ๐Ÿ“ Improve Docs - Help us document better
  4. ๐Ÿ”ง Submit PRs - Fix bugs or add features

See CONTRIBUTING.md for detailed guidelines.


๐Ÿ“œ License

This project is licensed under the MIT License - see LICENSE for details.

โš–๏ธ Disclaimer

This project is an independent implementation and is not officially affiliated with Meta Platforms, Inc. or any of its affiliates.

  • โœ… Educational and development purposes
  • โœ… Use responsibly and ethically
  • โœ… Comply with Meta's Terms of Service
  • โœ… Respect usage limits and policies

Llama 3 License: Visit llama.com/llama3/license for Llama 3 usage terms.


๐Ÿ™ Acknowledgments

  • Meta AI - For providing the AI capabilities
  • Llama 3 - The powerful language model
  • Open Source Community - For inspiration and support

๐Ÿ“ž Support & Community


๐Ÿš€ Quick Links

Resource Link
๐Ÿ“ฆ PyPI Package pypi.org/project/metaai_api
๐Ÿ™ GitHub Repository github.com/mir-ashiq/meta-ai-python
๐Ÿ“– Full Documentation Video Guide โ€ข Quick Ref
๐Ÿ’ฌ Get Help Issues โ€ข Discussions

Meta AI Python SDK v2.0.0 | Made with โค๏ธ by mir-ashiq | MIT License

โญ Star this repo if you find it useful!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

metaai_sdk-3.0.1.tar.gz (2.3 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

metaai_sdk-3.0.1-py3-none-any.whl (43.5 kB view details)

Uploaded Python 3

File details

Details for the file metaai_sdk-3.0.1.tar.gz.

File metadata

  • Download URL: metaai_sdk-3.0.1.tar.gz
  • Upload date:
  • Size: 2.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for metaai_sdk-3.0.1.tar.gz
Algorithm Hash digest
SHA256 8d4ba9dc2838ad03516604862692baed09ce40546276b558610d5f6075c94048
MD5 8b43556b98bf9484da27a0fea947d955
BLAKE2b-256 69394a41cb18369a2be16e321c68ac1af64d0431ab3838d8129ad58c3f41bea8

See more details on using hashes here.

Provenance

The following attestation bundles were made for metaai_sdk-3.0.1.tar.gz:

Publisher: publish.yml on mir-ashiq/metaai-api

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file metaai_sdk-3.0.1-py3-none-any.whl.

File metadata

  • Download URL: metaai_sdk-3.0.1-py3-none-any.whl
  • Upload date:
  • Size: 43.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for metaai_sdk-3.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 551c9845795e23bd3d20fcd7bd2cdb8be8d97b281fb155f62c97603ac8d6cde3
MD5 8673ef160eb9129d82409f391847fb5d
BLAKE2b-256 66f230f15ade96f3b67db2045a8df003e69afcc694bf60ce52aa10ecb1759e67

See more details on using hashes here.

Provenance

The following attestation bundles were made for metaai_sdk-3.0.1-py3-none-any.whl:

Publisher: publish.yml on mir-ashiq/metaai-api

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page