Download the PHP package bmadigan/overpass without Composer
On this page you can find all versions of the php package bmadigan/overpass. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download bmadigan/overpass
More information about bmadigan/overpass
Files in bmadigan/overpass
Package overpass
Short Description A robust Laravel package for integrating Python AI capabilities through a secure subprocess bridge
License MIT
Homepage https://github.com/bmadigan/overpass
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package overpass
Overpass
A robust Laravel package for integrating Python AI capabilities through a secure subprocess bridge. Instead of reimplementing complex AI libraries in PHP, this package provides a clean interface to delegate AI operations to Python's rich ecosystem (OpenAI, LangChain, scikit-learn, etc.).
🎬 Demo Application
Check out Ask-My-Doc - a sophisticated document Q&A system built with Overpass that showcases real-world AI integration:
Ask-My-Doc demonstrates Overpass in action with:
- 📄 Document ingestion and intelligent chunking
- 🔍 Semantic search using OpenAI embeddings
- 💬 AI-powered Q&A with source citations
- ⚡ Real-time Python bridge status monitoring
- 🎨 Beautiful dark-themed UI inspired by Linear
Note: This package is not affiliated with the existing decodelabs/overpass package, which provides a PHP bridge to Node.js. Our "Overpass" package serves a different purpose - bridging between PHP and Python for AI operations.
🚀 Features
- 🐍 Python Integration: Seamlessly execute Python AI scripts from Laravel
- 🔒 Secure: API keys passed via environment variables, never in command lines
- ⚡ Async Ready: Built for Laravel queues and background processing
- 🛡️ Robust Error Handling: Graceful degradation and comprehensive logging
- 🧪 Production Tested: Battle-tested patterns for reliability
- 🎯 Laravel Native: Follows Laravel conventions with facades, service providers, and Artisan commands
📦 Installation
You can install the package via composer:
Install the package with example Python scripts:
Publish the config file:
⚙️ Configuration
Add your OpenAI API key to your .env file:
Configure the package in config/overpass.php:
🎯 Usage
Basic Usage
Chat Operations
Vector Search
Queue Integration
🐍 Python Script Structure
Your Python script should follow this pattern:
🧪 Testing
📚 Advanced Usage
Custom Operations
Error Handling
Dependency Injection
🔧 Artisan Commands
🚨 Troubleshooting
Connection Failures:
- Ensure Python 3 is installed and accessible
- Check that your Python script path is correct
- Verify Python dependencies are installed
- Test your OpenAI API key
Performance Issues:
- Increase timeout for complex operations
- Use Laravel queues for long-running tasks
- Consider output length limits
Memory Issues:
- Set appropriate
max_output_lengthin config - Use streaming for large datasets
- Monitor Python process memory usage
📊 Performance Considerations
- Timeouts: Set appropriate timeouts based on operation complexity
- Memory: Monitor both PHP and Python memory usage
- Queues: Use Laravel queues for expensive AI operations
- Caching: Cache embedding results and AI responses when appropriate
🔒 Security
- API keys are passed via environment variables, never command line arguments
- All input data is JSON-encoded to prevent injection attacks
- Process isolation ensures Python failures don't crash Laravel
- Comprehensive logging for audit trails
🤝 Contributing
Contributions are welcome! Please see CONTRIBUTING for details.
🐛 Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
📄 Credits
- Your Name
- All Contributors
📜 License
The MIT License (MIT). Please see License File for more information.
All versions of overpass with dependencies
spatie/laravel-package-tools Version ^1.92
illuminate/contracts Version ^11.0|^12.0
symfony/process Version ^6.0|^7.0