Scraperly 🎬

Transform your text into captivating AI-narrated videos with matching visuals! 🚀

Scraperly is your all-in-one Python toolkit for creating engaging AI-powered videos. It seamlessly combines web scraping, AI content processing, and video generation to turn your text into professional-looking videos with minimal effort.

📚 Table of Contents

• ✨ Features
• 🚀 Quick Start
• ⚙️ Installation
• 🎯 Use Cases
• 🛠️ Advanced Usage
• 🤖 AI Providers
• 🔧 Troubleshooting
• 👥 Contributing
• 📝 License

✨ Features

• 🎥 One-Click Video Creation: Transform text into professional videos
• 🤖 Multiple AI Providers: Choose from OpenAI, Anthropic, Hyperbolic, or Ollama
• 🖼️ Smart Image Scraping: Automatic image sourcing from Lexica.art
• 🗣️ Natural Narration: High-quality text-to-speech conversion
• ⚡ Fast Processing: Efficient content segmentation and processing
• 🎨 Customizable Output: Control image count and video parameters

🚀 Quick Start

from scraperly import scraperly
import os

# Create your first AI video in just 3 lines!
result = scraperly(
    content="Your story or content here",
    provider_name="openai",
    api_key=os.getenv("OPENAI_API_KEY"),
    model="gpt-4"
)

⚙️ Installation

📦 Using pip (Recommended)

# Basic installation
pip install scraperly

# With AI provider support
pip install "scraperly[ai]"

# Set up your API keys (recommended)
export OPENAI_API_KEY="your-openai-api-key"
export ANTHROPIC_API_KEY="your-anthropic-api-key"

🔧 From Source

# Clone and install
git clone https://github.com/adelelawady/scraperly.git
cd scraperly
pip install -e ".[ai]"

🎯 Use Cases

1. Story Visualization

from scraperly import scraperly
import os

# Turn a story into an engaging video
story = """
The ancient castle stood silently against the twilight sky,
its weathered stones holding centuries of secrets...
"""

result = scraperly(
    content=story,
    provider_name="anthropic",
    api_key=os.getenv("ANTHROPIC_API_KEY"),
    model="claude-3-sonnet",
    max_images_per_segment=3
)

2. Educational Content

from scraperly import scraperly
import os

# Create educational videos
lesson = """
The Solar System consists of eight planets orbiting around the Sun.
Each planet has unique characteristics...
"""

result = scraperly(
    content=lesson,
    provider_name="openai",
    api_key=os.getenv("OPENAI_API_KEY"),
    model="gpt-4-turbo",
    max_images_per_segment=2,
    output_video_path="solar_system.mp4"
)

🤖 AI Providers

🔧 Troubleshooting

🤝 Contributing

We love your input! To contribute:

1. 🍴 Fork the repo
2. 🌿 Create your branch (git checkout -b feature/AmazingFeature)
3. 💾 Commit changes (git commit -m 'Add AmazingFeature')
4. 📤 Push to branch (git push origin feature/AmazingFeature)
5. 🎁 Open a Pull Request

📝 License

Released under MIT License. See LICENSE for details.

👤 Author

Created with 💖 by adelelawady

Made with ❤️ for the AI community