fleeks-sdk 0.2.0

Python SDK for Fleeks services

Fleeks Python SDK

Production-ready Python SDK for the Fleeks AI Development Platform

Documentation | Website | API Reference

---

Fleeks is a revolutionary AI-powered development platform that provides instant polyglot workspaces with 11+ languages, AI agents, and complete development environments.

✨ Key Features

• 🏃 Sub-Second Workspaces - Create complete dev environments in <200ms
• 🌐 11+ Languages - Python, Node, Go, Rust, Java, Ruby, PHP, and more
• 🤖 AI Agents - Code generation, debugging, testing, research
• 📁 Full File System - Complete CRUD operations with safety features
• 💻 Terminal Control - Sync/async command execution, background jobs
• 📦 Container Management - Real-time stats, process control
• 🔄 Real-time Streaming - WebSocket file watching and agent streaming
• ⚡ Async/Await - Built for high performance
• 🔐 Enterprise Security - API key auth with scopes

📦 Installation

pip install fleeks-sdk

🚀 Quick Start

import asyncio
from fleeks_sdk import FleeksClient

async def main():
    # Initialize client
    client = FleeksClient(api_key="fleeks_sk_your_key_here")
    
    # Create workspace with Python - includes instant preview URLs!
    workspace = await client.workspaces.create(
        project_id="my-project",
        template="python"
    )
    
    print(f"🌐 Preview URL: {workspace.preview_url}")
    print(f"🔌 WebSocket URL: {workspace.websocket_url}")
    
    # Create a web server
    await workspace.files.create(
        path="app.py",
        content="""
from flask import Flask
app = Flask(__name__)

@app.route('/')
def home():
    return 'Hello from Fleeks!'

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=8080)
"""
    )
    
    # Install Flask and start server
    await workspace.terminal.execute("pip install flask")
    await workspace.terminal.execute("python app.py", background=True)
    
    # Get preview URL details
    preview = await workspace.get_preview_url()
    print(f"🚀 Your app is live at: {preview.preview_url}")
    
    # Use AI agent
    agent = await workspace.agents.execute(
        task="Add unit tests",
        agent_type="test"
    )
    await workspace.agents.wait_for_completion(agent.agent_id)
    
    # Cleanup
    await workspace.delete()

asyncio.run(main())

📖 Core Features

🌐 Preview URLs (NEW!)

Get instant HTTPS access to your workspace applications with zero configuration:

# Create workspace - preview URLs included automatically!
workspace = await client.workspaces.create("my-app", "python")

# Access preview URLs immediately
print(workspace.preview_url)     # https://preview.fleeks.ai/my-app/
print(workspace.websocket_url)   # wss://ws.fleeks.ai/my-app/

# Start your Flask/Express/React app
await workspace.terminal.execute("python app.py", background=True)

# Get detailed preview info
preview = await workspace.get_preview_url()
print(f"Status: {preview.status}")
print(f"Container: {preview.container_id}")

# Your app is now live at: https://preview.fleeks.ai/my-app/

Features:

• ✅ Automatic HTTPS with SSL certificates
• ✅ WebSocket support for real-time features
• ✅ Global CDN distribution
• ✅ Zero configuration required
• ✅ Works with any framework (Flask, Express, React, Next.js, etc.)

Workspaces

# Create with specific languages
workspace = await client.workspaces.create(
    "my-app",
    template="python",
    pinned_versions={"python": "3.11", "node": "20"}
)

# Check health
health = await workspace.get_health()
print(f"Status: {health.status}, Uptime: {health.uptime_seconds}s")

Files

# Create, read, update, delete
await workspace.files.create("src/main.py", content="...")
content = await workspace.files.read("src/main.py")
await workspace.files.update("src/main.py", content="...")
await workspace.files.delete("src/main.py")

# Directories
await workspace.files.mkdir("src/utils")
listing = await workspace.files.list("/", recursive=True)

Terminal

# Sync execution
result = await workspace.terminal.execute("npm test")

# Background jobs
job = await workspace.terminal.start_background_job("npm run dev")
await workspace.terminal.wait_for_job(job.job_id)

AI Agents

# Execute agent task
agent = await workspace.agents.execute(
    task="Create REST API with auth",
    agent_type="code",
    context={"framework": "FastAPI"}
)

# Monitor progress
status = await workspace.agents.get_status(agent.agent_id)
print(f"Progress: {status.progress}%")

# Get results
output = await workspace.agents.get_output(agent.agent_id)
print(f"Files created: {len(output.files_created)}")

📚 Documentation

• Full Documentation: See SDK_IMPLEMENTATION_PLAN_VERIFIED.md
• Examples: Check examples/complete_examples.py
• API Reference: All modules are fully documented with docstrings

Running Tests

pytest

Code Formatting

black fleeks_sdk tests
isort fleeks_sdk tests

Type Checking

mypy fleeks_sdk

License

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

Contributing

Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.

Support

For support, email [e-mail] or create an issue on GitHub.