https://github.com/pyfilament/pyfilament

lightweight task framework
https://github.com/pyfilament/pyfilament

distributed-computing durable-execution observability task-queue

Last synced: about 4 hours ago
JSON representation

lightweight task framework

• Host: GitHub
• URL: https://github.com/pyfilament/pyfilament
• Owner: pyfilament
• License: apache-2.0
• Created: 2026-06-08T23:27:47.000Z (8 days ago)
• Default Branch: main
• Last Pushed: 2026-06-17T02:32:28.000Z (about 5 hours ago)
• Last Synced: 2026-06-17T04:00:14.757Z (about 4 hours ago)
• Topics: distributed-computing, durable-execution, observability, task-queue
• Language: Python
• Homepage: https://pyfilament.io
• Size: 765 KB
• Stars: 4
• Watchers: 3
• Forks: 3
• Open Issues: 4
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
[![pypi package version](https://img.shields.io/pypi/v/pyfilament)](https://pypi.org/project/pyfilament/) [![python version](https://img.shields.io/pypi/pyversions/pyfilament)](https://pypi.org/project/pyfilament/) [![pytest](https://github.com/pyfilament/pyfilament/actions/workflows/pytest.yml/badge.svg)](https://github.com/pyfilament/pyfilament/actions/workflows/pytest.yml) [![codecov](https://codecov.io/github/pyfilament/pyfilament/graph/badge.svg?token=DIUIQG3YMW)](https://codecov.io/github/pyfilament/pyfilament) [![discord](https://img.shields.io/discord/1516547508837285958?logo=discord)](https://discord.gg/RgyZceR53B)

# pyfilament

lightweight task framework

Features

* timeouts / retries / caching

* token-bucket and concurrency limits

* subtasks, queues, and distributed workers

* task cancellation and graceful worker shutdown

* state timeline tracking, logging, args inspection

# Getting Started

```

uv add pyfilament

uv run - << 'EOF'

from filament import task

from asyncio import run

@task

async def foo():

    return 'bar'

run(foo())

EOF

```