metaai-sdk 2.0.0__tar.gz

metaai_sdk-2.0.0/CHANGELOG.md

@@ -0,0 +1,159 @@
+# Changelog
+
+All notable changes to Meta AI Python SDK will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [2.0.0] - 2025-11-22
+
+### 🎉 Initial Release
+
+First stable release of the Meta AI Python SDK with comprehensive features for Meta AI interaction.
+
+### Added
+
+- 🎬 **Video Generation Support** - Generate AI videos from text prompts
+
+  - New `generate_video()` method in `MetaAI` class
+  - `VideoGenerator` class for advanced video generation control
+  - Automatic token fetching (lsd, fb_dtsg) from cookies
+  - Video URL polling with configurable timeout
+  - Support for multiple video qualities (HD/SD)
+
+- 🔐 **Automatic Token Management**
+
+  - Auto-fetch missing `lsd` and `fb_dtsg` tokens from Meta AI
+  - No manual token configuration required
+  - Seamless integration with existing cookie authentication
+
+- 📚 **Enhanced Documentation**
+
+  - Complete video generation guide (`VIDEO_GENERATION_README.md`)
+  - API reference with detailed parameters
+  - Multiple usage examples
+  - Troubleshooting section
+  - Migration guide from old code
+
+- 📦 **Clean Project Structure**
+  - Organized examples directory
+  - Clear separation of concerns
+  - Removed temporary/test files
+  - Added `.gitignore` for clean repository
+
+### Changed
+
+- ♻️ Refactored `MetaAI.__init__()` to support automatic token fetching
+- 📖 Updated main README with video generation section
+- 🏗️ Improved project structure for better maintainability
+
+### Examples
+
+- `examples/simple_example.py` - Basic chat and video generation
+- `examples/video_generation.py` - Comprehensive video examples
+- `examples/test_example.py` - Testing and validation
+
+### Technical Details
+
+- Video generation uses GraphQL API with multipart/form-data
+- Dynamic header construction for different request types
+- Recursive JSON parsing for video URL extraction
+- Configurable polling mechanism (max_attempts, wait_seconds)
+
+---
+
+## [1.x.x] - Previous Versions
+
+### Features
+
+- Chat with Meta AI (Llama 3)
+- Image generation (FB authenticated users)
+- Real-time internet-connected responses
+- Source citation
+- Streaming support
+- Conversation continuity
+- Proxy support
+
+---
+
+## Future Enhancements
+
+### Planned Features
+
+- [ ] Video download functionality
+- [ ] Batch video generation
+- [ ] Video quality selection
+- [ ] Advanced filtering for video URLs
+- [ ] Async/await support for video generation
+- [ ] Rate limiting and retry logic
+- [ ] Video generation progress callbacks
+- [ ] Custom video orientation (landscape/portrait/square)
+- [ ] Video duration control
+- [ ] Style presets for video generation
+
+### Under Consideration
+
+- [ ] Video editing capabilities
+- [ ] Frame extraction from generated videos
+- [ ] Video concatenation
+- [ ] Audio generation integration
+- [ ] Video template support
+
+---
+
+## Migration Guide
+
+### From v1.x to v2.0
+
+**Video Generation** (NEW):
+
+```python
+# New in v2.0
+from metaai_api import MetaAI
+
+ai = MetaAI(cookies=cookies)
+result = ai.generate_video("Generate a video of a sunset")
+```
+
+**Token Management** (IMPROVED):
+
+```python
+# Old way (manual)
+cookies = {
+    "datr": "...",
+    "lsd": "...",      # Had to provide manually
+    "fb_dtsg": "..."   # Had to provide manually
+}
+
+# New way (automatic)
+cookies = {
+    "datr": "...",
+    "abra_sess": "..."
+    # lsd and fb_dtsg auto-fetched!
+}
+```
+
+**Backward Compatibility**:
+All existing v1.x features remain fully compatible. No breaking changes to chat or image generation APIs.
+
+---
+
+## Contributing
+
+We welcome contributions! Areas of interest:
+
+- Video generation enhancements
+- Performance optimizations
+- Additional features from roadmap
+- Bug fixes
+- Documentation improvements
+
+---
+
+## License
+
+MIT License - See LICENSE file for details
+
+---
+
+**Meta AI Python SDK** - Built with ❤️ for developers

metaai_sdk-2.0.0/CONTRIBUTING.md

@@ -0,0 +1,292 @@
+# Contributing to Meta AI Python SDK
+
+First off, thank you for considering contributing to Meta AI Python SDK! 🎉
+
+## 📋 Table of Contents
+
+- [Code of Conduct](#code-of-conduct)
+- [Getting Started](#getting-started)
+- [Development Setup](#development-setup)
+- [How to Contribute](#how-to-contribute)
+- [Pull Request Process](#pull-request-process)
+- [Coding Standards](#coding-standards)
+- [Testing](#testing)
+
+## 📜 Code of Conduct
+
+This project and everyone participating in it is governed by our commitment to providing a welcoming and inclusive environment. Please be respectful and constructive in all interactions.
+
+## 🚀 Getting Started
+
+1. **Fork the repository** on GitHub
+2. **Clone your fork** locally:
+   ```bash
+   git clone https://github.com/YOUR-USERNAME/meta-ai-python.git
+   cd meta-ai-python
+   ```
+3. **Create a branch** for your contribution:
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
+
+## 💻 Development Setup
+
+### Prerequisites
+
+- Python 3.7 or higher
+- pip or poetry for package management
+- Git for version control
+
+### Install Dependencies
+
+```bash
+# Create virtual environment
+python -m venv venv
+
+# Activate virtual environment
+# On Windows:
+venv\Scripts\activate
+# On macOS/Linux:
+source venv/bin/activate
+
+# Install package in development mode
+pip install -e .
+
+# Install development dependencies
+pip install -e ".[dev]"
+```
+
+### Project Structure
+
+```
+meta-ai-python/
+├── src/metaai_api/
+│   ├── __init__.py
+│   ├── main.py              # Core MetaAI class
+│   ├── video_generation.py  # Video generation
+│   ├── utils.py
+│   ├── exceptions.py
+│   └── client.py
+├── examples/
+├── tests/                   # Unit tests (coming soon)
+├── README.md
+└── setup.py
+```
+
+## 🤝 How to Contribute
+
+### Reporting Bugs
+
+- **Search existing issues** first to avoid duplicates
+- Use the **bug report template** when creating a new issue
+- Include:
+  - Python version
+  - Package version
+  - Minimal code to reproduce the issue
+  - Expected vs actual behavior
+  - Error messages/stack traces
+
+### Suggesting Features
+
+- **Search existing issues** for similar suggestions
+- Use the **feature request template**
+- Describe:
+  - The problem your feature solves
+  - Proposed solution
+  - Alternative solutions considered
+  - Use cases and examples
+
+### Code Contributions
+
+We welcome contributions in these areas:
+
+1. **Bug fixes** - Fix reported issues
+2. **New features** - Implement from roadmap or new ideas
+3. **Documentation** - Improve guides, docstrings, examples
+4. **Tests** - Add unit tests, integration tests
+5. **Performance** - Optimize existing functionality
+6. **Examples** - Add practical usage examples
+
+## 🔄 Pull Request Process
+
+1. **Update your fork**:
+
+   ```bash
+   git remote add upstream https://github.com/meta-ai-sdk/meta-ai-python.git
+   git fetch upstream
+   git merge upstream/main
+   ```
+
+2. **Make your changes**:
+
+   - Write clean, readable code
+   - Follow existing code style
+   - Add docstrings to new functions/classes
+   - Update documentation if needed
+
+3. **Test your changes**:
+
+   ```bash
+   # Run examples
+   python examples/simple_example.py
+
+   # Test with different Python versions if possible
+   ```
+
+4. **Commit your changes**:
+
+   ```bash
+   git add .
+   git commit -m "feat: add video quality selection"
+   ```
+
+   Use conventional commits:
+
+   - `feat:` - New feature
+   - `fix:` - Bug fix
+   - `docs:` - Documentation changes
+   - `refactor:` - Code refactoring
+   - `test:` - Adding tests
+   - `chore:` - Maintenance tasks
+
+5. **Push to your fork**:
+
+   ```bash
+   git push origin feature/your-feature-name
+   ```
+
+6. **Create Pull Request**:
+   - Go to the original repository
+   - Click "New Pull Request"
+   - Select your fork and branch
+   - Fill in the PR template
+   - Link related issues
+
+### PR Review Process
+
+- Maintainers will review your PR within a few days
+- Address any requested changes
+- Once approved, your PR will be merged!
+
+## 📏 Coding Standards
+
+### Python Style Guide
+
+- Follow **PEP 8** style guide
+- Use **type hints** where appropriate
+- Maximum line length: **100 characters**
+- Use **descriptive variable names**
+
+### Code Formatting
+
+```bash
+# Format with black (recommended)
+pip install black
+black src/
+
+# Check with flake8
+pip install flake8
+flake8 src/
+```
+
+### Documentation
+
+- Add **docstrings** to all public functions/classes
+- Use **Google-style** docstrings:
+
+```python
+def generate_video(prompt: str, wait_before_poll: int = 10) -> Dict:
+    """
+    Generate a video from a text prompt.
+
+    Args:
+        prompt: Text description for video generation
+        wait_before_poll: Seconds to wait before polling
+
+    Returns:
+        Dictionary with success status and video URLs
+
+    Raises:
+        ValueError: If prompt is empty
+
+    Example:
+        >>> ai = MetaAI(cookies=cookies)
+        >>> result = ai.generate_video("sunset")
+    """
+```
+
+## 🧪 Testing
+
+### Running Tests
+
+```bash
+# Run all tests (when available)
+pytest tests/
+
+# Run specific test file
+pytest tests/test_video_generation.py
+
+# Run with coverage
+pytest --cov=metaai_api tests/
+```
+
+### Writing Tests
+
+- Add tests for new features
+- Ensure existing tests pass
+- Aim for high code coverage
+- Use meaningful test names
+
+```python
+def test_video_generation_with_valid_prompt():
+    """Test video generation with a valid prompt."""
+    ai = MetaAI(cookies=test_cookies)
+    result = ai.generate_video("test prompt")
+    assert result["success"] is True
+```
+
+## 📝 Documentation Updates
+
+When adding features, update:
+
+- **README.md** - If it changes core usage
+- **CHANGELOG.md** - Add entry under "Unreleased"
+- **VIDEO_GENERATION_README.md** - For video-related features
+- **Docstrings** - In code
+- **Examples** - Add practical examples
+
+## 🎯 Priority Areas
+
+We're especially interested in contributions for:
+
+- [ ] Unit tests and test coverage
+- [ ] Async/await support
+- [ ] Video download functionality
+- [ ] Batch processing capabilities
+- [ ] Rate limiting and retry logic
+- [ ] Performance optimizations
+- [ ] Additional examples and tutorials
+- [ ] Documentation improvements
+
+## 💡 Questions?
+
+- **General questions**: Open a GitHub Discussion
+- **Bug reports**: Create an issue with bug template
+- **Feature requests**: Create an issue with feature template
+- **Security issues**: Email contact@meta-ai-sdk.dev
+
+## 🌟 Recognition
+
+Contributors will be:
+
+- Listed in CHANGELOG.md for their contributions
+- Acknowledged in release notes
+- Added to CONTRIBUTORS.md (coming soon)
+
+## 📄 License
+
+By contributing, you agree that your contributions will be licensed under the MIT License.
+
+---
+
+**Thank you for making Meta AI Python SDK better!** 🚀

metaai_sdk-2.0.0/LICENSE

@@ -0,0 +1,28 @@
+MIT License
+
+Copyright (c) 2025 Meta AI SDK Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+DISCLAIMER:
+This project is an independent implementation and is not officially affiliated
+with, authorized, maintained, sponsored, or endorsed by Meta Platforms, Inc.
+or any of its affiliates or subsidiaries.

metaai_sdk-2.0.0/MANIFEST.in

@@ -0,0 +1,48 @@
+# MANIFEST.in - Include/Exclude files for distribution
+
+# Include documentation
+include README.md
+include LICENSE
+include CHANGELOG.md
+include CONTRIBUTING.md
+include SECURITY.md
+include ARCHITECTURE.md
+include VIDEO_GENERATION_README.md
+include QUICK_REFERENCE.md
+
+# Include configuration files
+include pyproject.toml
+include setup.py
+include setup.cfg
+include requirements.txt
+
+# Include examples
+recursive-include examples *.py
+
+# Include package data
+recursive-include src/metaai_api *.py
+
+# Exclude development and build files
+exclude .gitignore
+exclude .gitattributes
+recursive-exclude * __pycache__
+recursive-exclude * *.py[co]
+recursive-exclude * *.so
+recursive-exclude * *.dylib
+recursive-exclude * .DS_Store
+
+# Exclude tests and CI
+recursive-exclude tests *
+recursive-exclude .github *
+
+# Exclude IDE and editor files
+recursive-exclude * .vscode
+recursive-exclude * .idea
+recursive-exclude * *.swp
+recursive-exclude * *.swo
+recursive-exclude * *~
+
+# Exclude temporary files
+recursive-exclude * *.tmp
+recursive-exclude * *.bak
+recursive-exclude * *.log