falkourier
falkourier is a Python library that draws images, sketches, and curves using Fourier series epicycles (rotating circles). It converts any 2D outline into mathematical harmonic frequencies and animates the drawing process.
Created by @falkomeai.
- Live Web Studio: https://falkourier.streamlit.app/
- GitHub Repository: falkomeAI/falkourier
Installation
pip install falkourier
Quick Start
1. Web Studio UI
The easiest way to use it is through the interactive web interface:
falkourier-studio
This launches a local web app in your browser where you can upload an image, tune the number of harmonics, preview the epicycles live, and export MP4 videos.
2. Command Line
You can also generate videos directly from your terminal:
# Render a video from an image
falkourier --image portrait.jpg --n 500 --save output.mp4
# Render vertical 9:16 format (for Instagram Reels or TikTok)
falkourier --shape hummingbird --n 300 --format reels --save reel.mp4
# Render from built-in curves
falkourier --shape heart --n 200 --save heart.mp4
3. Python Code
import falkourier as fk
# 1. Use a built-in curve or extract from an image
path = fk.SHAPES["hummingbird"]()
# path = fk.extract_boundary_contour_path("portrait.jpg", target_points=2048)
# 2. Fit Fourier series
fit = fk.fit_fourier(path[:, 0], path[:, 1], n_harmonics=500)
print(f"X harmonics: {len(fit['x_coeffs']['an'])}")
print(f"Y harmonics: {len(fit['y_coeffs']['cn'])}")
Built-in Shapes
You can try out any of the built-in mathematical curves:
hummingbird, heart, star, butterfly, infinity, spiral, rose.
import falkourier as fk
curve = fk.SHAPES["butterfly"]()
Author & License
- Built by @falkomeai
- Distributed under the MIT License
1 maintainer
Metadata
1 maintainer
Release files for falkourier 1.0.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| falkourier-1.0.3.tar.gz | 45.4 kB | Without provenance | Details for falkourier-1.0.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| falkourier-1.0.3-py3-none-any.whl | Python 3 | none | any | Details for falkourier-1.0.3-py3-none-any.whl |
Total release size: 89.9 kB
Release files / falkourier-1.0.3.tar.gz
| Download URL | falkourier-1.0.3.tar.gz |
|---|---|
| Size | 45.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d6f060284d25a108d7577e6b72595fa205ea782a99417aed119f040a9e61434a
|
|
BLAKE2b-256 checksum How to use checksums |
56c5bf9a7acd48fe7377c6ff8a9fa7a75e3df4f92942e3d86751fafa300b150e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Release files / falkourier-1.0.3-py3-none-any.whl
| Download URL | falkourier-1.0.3-py3-none-any.whl |
|---|---|
| Size | 44.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0fb5bca1c38280825031da1fb88f1d479aedcec942ed36b25acfe556dc3a2a51
|
|
BLAKE2b-256 checksum How to use checksums |
e5df73d7574f00c3c76e826da6a5068d6db0c2234c84c77d48e3dc8cb855f7fd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
Security for falkourier 1.0.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
