A FastAPI-based backend service for generating images using Enana UI library.
- FastAPI Framework: High-performance, easy-to-use web framework
- Enana Integration: Generate images from JSON UI configurations
- RESTful API: Well-designed API with Swagger documentation
- Containerized: Docker support for easy deployment
- Logging: Comprehensive logging for monitoring and debugging
- CORS Support: Cross-origin resource sharing enabled
- Health Check: Built-in health check endpoint
- Python 3.13 or higher
- uv (Python package manager and virtual environment tool)
- Docker (optional, for containerized deployment)
-
Clone the repository
git clone https://github.com/Parallel-SEKAI/Enana.git cd enana_api -
Create and activate virtual environment
uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate
-
Install dependencies
uv install
uv run start
The application will be available at http://localhost:8000
docker-compose up -d
The application will be available at http://localhost:8000
- Swagger UI:
http://localhost:8000/docs - ReDoc:
http://localhost:8000/redoc
Generate image from JSON configuration.
Request Body:
{
"widget": {
"type": "Page",
"child": {
"type": "Container",
"width": 400,
"height": 300,
"color": [255, 255, 255, 255],
"child": {
"type": "Text",
"text": "Hello, Enana!",
"font_size": 24,
"color": [0, 0, 0, 255]
}
}
},
"scale": 1.0
}Response:
200 OK: Returns generated image in PNG format400 Bad Request: Invalid request parameters500 Internal Server Error: Error generating image
curl -X POST "http://localhost:8000/api/v1/image/generate" \ -H "Content-Type: application/json" \ -d '{"widget": {"type": "Page", "child": {"type": "Text", "text": "Hello"}}, "scale": 1.0}' \ -o output.png
import requests import json url = "http://localhost:8000/api/v1/image/generate" payload = { "widget": { "type": "Page", "child": { "type": "Container", "width": 400, "height": 300, "color": [255, 255, 255, 255], "child": { "type": "Text", "text": "Hello, Enana!", "font_size": 24, "color": [0, 0, 0, 255] } } }, "scale": 1.0 } response = requests.post(url, json=payload) if response.status_code == 200: with open("output.png", "wb") as f: f.write(response.content) print("Image generated successfully!") else: print(f"Error: {response.status_code} - {response.text}")
enana_api/
├── app/
│ ├── api/ # API routes
│ ├── core/ # Core configuration
│ ├── services/ # Business logic
│ └── schemas/ # Data models
├── tests/ # Test scripts
├── Dockerfile # Docker configuration
├── docker-compose.yml # Docker Compose configuration
├── pyproject.toml # Project dependencies
└── README.md # This file
The application can be configured using environment variables:
DEBUG: Enable/disable debug mode (default:True)LOG_LEVEL: Log level (default:INFO)HOST: Server host (default:0.0.0.0)PORT: Server port (default:8000)
Run tests using pytest:
uv run pytest
MIT License
Contributions are welcome! Please feel free to submit a Pull Request.