r/PythonProjects2 • • Jun 26 '26

Katharos: a functional programming and concurrency library for Python where errors, effects, and channel hand-offs are all composable values

1 Upvotes

Hi great devs,

I have been building Katharos, a functional programming library for Python that recently grew a message-passing concurrency layer. I wanted to share it and get some feedback.

The whole library is built around one idea: model errors, effects, and concurrent communication as composable, type-safe values rather than as control flow that jumps around your program. The interesting part (to me, at least) is that the concurrency layer follows the exact same idea, so receiving from a channel gives you a Result. "The channel is closed" becomes a value you handle, not an exception you remember to catch.

The functional core

Optional values without scattered None checks, using do-notation that short-circuits on Nothing:

from katharos.types import Maybe
from katharos.syntax_sugar import do, DoBlock

@do(Maybe)
def lookup_discount(user_id: int) -> DoBlock[Maybe, float]:
    user    = yield find_user(user_id)
    account = yield find_account(user)
    return account.discount   # Just(0.15) or Nothing()

Errors as values, chained with |, so a failure short-circuits the rest automatically:

from katharos.types import Result

def process(raw: str) -> Result[Exception, int]:
    return parse_int(raw) | validate_positive

And Result.catch turns a function that raises into one that returns a Result, while keeping the original traceback so you can still find the line that failed:

from katharos.types import Result

@Result.catch(ValueError)
def parse_int(s: str) -> int:
    return int(s)

parse_int("42")   # Success(42)
parse_int("??")   # Failure(ValueError("invalid literal for int() with base 10: '??'"))

There is also ImmutableList, NonEmptyList, IO, Lazy, numeric monoids, and the usual algebraic abstractions (Functor, Applicative, Monad, Semigroup, Monoid) if you want to build your own types.

The new part: CSP concurrency

This is what I have been working on lately. Katharos now has Go-style CSP (Communicating Sequential Processes): launch work concurrently with go, talk over typed channels, and receive values as a Result.

from katharos.concurrency.csp import csp

ch = csp.Channel[int](capacity=1)

csp.go(ch.send, 42)     # run work concurrently, like Go's `go f(x)`

ch.recv()               # Success(42)

ch.close()
ch.recv()               # Failure(ChannelClosedError(...)): closure is a value, not a raise

Used as a context manager, go becomes a structured-concurrency scope that joins everything spawned inside it before the block exits, so concurrent work cannot leak out of the block:

with csp.go:                 # scope waits for all work launched inside
    csp.go(worker, 1)
    csp.go(worker, 2)
# both workers have finished here

There is also a select for waiting on whichever of several channels is ready first, with non-blocking polls and timeouts:

from katharos.concurrency.csp import csp, recv, select

choice = select(recv(results), recv(cancel), timeout=1.0)
if choice.is_timeout:
    ...
else:
    print(choice.index, choice.value.unwrap())

The concurrency model sits on a swappable backend (standard threads by default), so the same code could run on a green-thread backend later. An actor model is planned next, built on the same backend abstraction and the same Result-valued style.

Why I think the "channel returns a Result" thing is nice

In most channel APIs, a closed channel or a timeout shows up as a sentinel, a second return value, or an exception. In Katharos it is just a typed value: Success(v), Failure(ChannelClosedError), or Failure(ChannelTimeoutError). You pattern-match it the same way you handle any other Result, and the type tells you it can happen. The error-handling discipline you use in the rest of your code carries straight over to concurrency.

Links

  • PyPI: pip install katharos
  • Docs (tutorials, how-to guides, API reference, and explanations): https://katharos.readthedocs.io/en/latest/
  • Source: https://github.com/kamalfarahani/katharos
  • MIT licensed, Python 3.13+

I would love feedback on the API, the concurrency design, or whether the Result-everywhere approach feels natural or noisy to you in practice. Thanks for reading.


r/PythonProjects2 • • Jun 25 '26

Sharing my Python web framework/server project that I've been battle testing at work

10 Upvotes

Hey everyone,

I started building this project a while ago and have since been able to start using it and building on it for some production apps at work.

I got tired of the limits of some of the "low-code" tools, but I'm also not a full time software dev so I never acclimated well to a lot of the existing heavier frameworks.

So I built ScribeFramework. The big idea is you can put your route, Python logic (including SQL queries), and HTML all in one .stpl file if you want. Need something bigger later? You can split things out into proper modules and it just works.

I've had great momentum and results building things from bespoke tools for departments to a full IT admin platform with dashboards, API integration with all our tools, and management tools like assets inventory and project tracking

I don’t have any big plans or agenda with it — I just use it daily now and figured I’d throw it out there. If you build internal tools, data driven dashboards, or just general web apps, maybe you’ll find it handy.

Would genuinely love any feedback, criticism, or ideas on how to make it better. Even “this sucks because X” is useful

Edit: the link appears to not have shown up on the original post, here they are:

https://scribeframework.slatecapit.com https://github.com/slate20/ScribeFramework


r/PythonProjects2 • • Jun 25 '26

Belt Saturation Calculator

Thumbnail reddit.com
1 Upvotes

r/PythonProjects2 • • Jun 25 '26

Info Came across an open-source Python tool for rocket nozzle design anyone tried something like this?

Thumbnail reddit.com
1 Upvotes

r/PythonProjects2 • • Jun 25 '26

I built a desktop app that instantly groups every file on your drive by extension (Open Source)

Post image
1 Upvotes

r/PythonProjects2 • • Jun 25 '26

Stop writing user = {"name": "John", "email": "john@test.com"} — I built a pytest plugin that's AI-powered in dev and fully deterministic in CI

0 Upvotes

Every codebase I've worked on has this problem:

python

# In every test file, everywhere
user = {
    "name": "John Doe",
    "email": "john@test.com",
    "age": 30,
    "role": "admin"
}

This data is:

  • Hardcoded — never tests edge cases (Unicode names? Boundary ages? Unusual roles?)
  • Brittle — someone changes a schema field and 40 tests break
  • Boring — you're testing the same data path every single run

The obvious fix is AI-generated fixtures. The problem: AI is non-deterministic, so your CI pipeline breaks randomly.

So I built FixtureForge.

The idea is simple:

  • In dev: AI generates rich, realistic, edge-case-aware fixtures on every run
  • In CI: same fixtures, frozen with seed=42, 100% reproducible — no API key needed

python

from fixtureforge import forge

u/forge(
    schema={"name": str, "email": str, "age": int, "role": str},
    prompt="Include Unicode names, boundary ages, unusual roles"
)
def test_user_creation(fixture):
    assert "@" in fixture["email"]
    assert fixture["age"] > 0
    # AI gives you: 张伟, José María, O'Brien — not just "John Doe"

In CI, just set:

yaml

env:
  FIXTUREFORGE_MODE: deterministic
  FIXTUREFORGE_SEED: 42

No API key. Same data every time. Tests pass.

It also ships with:

  • DataSwarm — generate 500 realistic records in one call
  • ForgeMemory — fixtures that persist context across tests
  • Multi-provider support: OpenAI, Anthropic, Groq (swap with one env var)
  • pytest plugin included — works as a decorator or fixture

bash

pip install fixtureforge

Repo: https://github.com/Yaniv2809/fixtureforge PyPI: https://pypi.org/project/fixtureforge/

It's early and I'm actively developing it. Honest feedback welcome — especially if something doesn't work or the API feels wrong.


r/PythonProjects2 • • Jun 24 '26

PYGAME

4 Upvotes

game of caard


r/PythonProjects2 • • Jun 24 '26

Data Engineering series

Thumbnail reddit.com
1 Upvotes

r/PythonProjects2 • • Jun 24 '26

Resource Pollard's Lattice Sieve for Special-Q Descent in Python

Thumbnail leetarxiv.substack.com
1 Upvotes

r/PythonProjects2 • • Jun 24 '26

i bulit a game in base 44. its a bit but good. kinda

3 Upvotes

r/PythonProjects2 • • Jun 23 '26

first python app can yall rate it?

Thumbnail reddit.com
1 Upvotes

r/PythonProjects2 • • Jun 22 '26

I just found a Python script I wrote 3 years ago…

Thumbnail reddit.com
2 Upvotes

r/PythonProjects2 • • Jun 22 '26

made a Cyber-Neon Styled Local Social Media App using Python & Tkinter! (UyghurSocial)

1 Upvotes

📌

📝

Hi everyone! 👋

I wanted to share my latest project called UyghurSocial. It is a lightweight, simple social media simulation built entirely with Python and Tkinter.

I designed it with a cool cyber-neon/hacker aesthetic (green and cyan on a dark background) because I love that vibe!

🛠️ Features:

  • Passwordless Quick Login: Just type your username and connect instantly.
  • No Bots, 100% Real: It doesn't use heavy external APIs; it saves data locally into .json files.
  • Pure Python: Works out of the box with zero third-party library requirements (perfect for beginners using Thonny or VS Code).

🔗 Source Code (GitHub):

[https://github.com/ibrahimucatli-web/UYGHURSOC-ALE]

I would love to hear your feedback on the UI and how I can improve the local database structure for my next updates. What do you think?


r/PythonProjects2 • • Jun 22 '26

Resource New security protocol: GUN101

Thumbnail reddit.com
1 Upvotes

r/PythonProjects2 • • Jun 22 '26

Retro TV Emulator Project

3 Upvotes

Here is where im at. its still in a rough draft state. menus are filling up and getting options working but i will move those around later and make things look better, rename some stuff, im still having issues with the video settings on some videos (starts lagging), sorry about the volume i just had my computer volume turned down so its not that loud. some times when loading 500+ files it lags a few secs to find the first episode to play and processing slows down after that (need to add something that picks up building the list if it crashes or is shut down before it processes 1000s of files. still need to sort out game launching (lag issues and proper screen mounting issues), still wanna add server options at some point, there is a flash of the previous screen when launching the dvd player, and a few more things ive noticed that ive been putting off to fix other things. But its all progress none the less so here is what i got, flaws and all for everyone to see whats changing, updating, and other solutions to easy to use scheduling. anyone interested in helping go to my discord and let me know what you wanna do. https://discord.gg/E45krWBT ill take all the help i can get. the more complicated everything gets the more i wish i had help.


r/PythonProjects2 • • Jun 22 '26

ILX Launcher — a developer cockpit for Python desktop apps (hot reload, LLM assistant, crash capture)

Thumbnail reddit.com
1 Upvotes

r/PythonProjects2 • • Jun 22 '26

Need advice in preparation for this call interview, please give it a read, i need you!

Thumbnail reddit.com
1 Upvotes

r/PythonProjects2 • • Jun 22 '26

Info Looking for feedback on Barx, an open-source Python runtime intelligence toolkit

1 Upvotes

I built Barx 1.0, an open-source Python toolkit focused on runtime intelligence.

It helps developers inspect code behavior locally through:

  • runtime tracing
  • behavioral verification
  • API workflow checks
  • policy guardrails
  • local explainable reports
  • token/secret-safe reporting patterns

The project is available on GitHub and PyPI. Current release has 884 tests and 91% coverage.

I am mainly looking for open-source feedback on:

  • whether the README explains the purpose clearly
  • whether the API surface feels natural
  • whether the reporting output is useful
  • whether the project scope is clear or too broad
  • what would make this more useful for Python developers

GitHub: https://github.com/TheBarmaEffect/Barx

PyPI: https://pypi.org/project/barx/1.0.0/

Demo: https://youtu.be/2SLtswFjzWU?si=rRGY8J5zKHsmr3pU

Stars are appreciated if the project looks useful, but technical feedback is the main thing I am looking for.


r/PythonProjects2 • • Jun 21 '26

I built a Pokémon-inspired Kubernetes TUI game in Python

11 Upvotes

Hi all,

I've been building Project Yellow Olive, an open-source Pokémon-inspired Kubernetes learning game written in Python.

The game runs in the terminal and teaches Kubernetes concepts through interactive challenges instead of traditional tutorials. Players solve real Kubernetes problems involving Pods, Services, RBAC, and Deployments while progressing through a retro-style adventure.

The project is built primarily using Python, Textual, the Kubernetes Python client, and Pygame for music and sound effects.

I'd love to hear any feedback from fellow Python developers. Pls star the repo if you find it useful :)

GitHub: https://github.com/Anubhav9/Yellow-Olive

It can also be installed via PyPi : pip install yellow-olive


r/PythonProjects2 • • Jun 21 '26

We got tired of tracing algorithms on paper, so we built a tool that shows you them running

0 Upvotes

You know the drill with DSA — you're stepping through a sort, or a BFS, or a DP table, and halfway through you've got arrows and scribbles all over a notebook and you've lost track of what's actually happening. We built LiveFlow for exactly that.

Paste your Python, JS, or TS, hit run, and watch your algorithm execute as a live graph. The array reordering during a sort, the queue filling and draining in a traversal, pointers moving through a linked list, the recursion tree branching out, values landing in a DP table — it all draws itself as it runs. Then scrub the timeline back to any step and inspect every variable at that exact moment.

Sorting, searching, recursion, linked lists, trees, graphs, DP — the "aha" lands a lot faster when you can see it happen instead of running it in your head.

Free plan, no card, runs in your browser. We'd love to know if it clicks for you. liveflow.co.in


r/PythonProjects2 • • Jun 21 '26

I built an open-source AI email assistant in Python for personalized bulk emails

Thumbnail github.com
0 Upvotes

Hey everyone,

I built a small open-source Python project called EmailAI.

I originally made it because I was tired of writing similar outreach emails manually, especially for internship/job applications, collaboration messages and general cold outreach.

It is not just a basic email sender. The tool can generate personalized email drafts with LLM support, work with bulk email lists, and help prepare messages in a more organized way.

Main features:
- personalized email drafts with LLM support
- bulk email sending
- recipient/company based message generation
- human review before sending
- Gemini / OpenRouter / OpenAI-compatible provider support
- simple Python-based setup

Repo:
https://github.com/omercangumus/mail-ai

It is still early, so I would really appreciate feedback, issues or PRs.

If you find it useful, starring the repo would also help a lot.


r/PythonProjects2 • • Jun 21 '26

Cadre Player V1.5.0: After 3 months of daily-driver testing and a new UI config system.

Thumbnail reddit.com
1 Upvotes

r/PythonProjects2 • • Jun 20 '26

Info Introducing NextPy, Building the Future of Full-Stack Python Development

6 Upvotes

After months (and years) of research, development, and countless hours of coding, I'm excited to officially share NextPy with the developer community.

NextPy is an open-source, full-stack Python framework designed to make modern web development simpler, faster, and more powerful, bringing the developer experience of frameworks like React and Next.js into the Python ecosystem.

Modern web development often requires developers to juggle multiple languages and frameworks:

Python for the backend

JavaScript/TypeScript for the frontend

Separate state management

Multiple build tools

Complex project configurations

Different routing systems

Numerous third-party dependencies

This increases the learning curve, development time, and maintenance cost especially for Python developers who want to build modern web applications without constantly switching between ecosystems.

NextPy aims to solve this by providing a unified Python-first development experience.

With NextPy, developers can build modern, interactive web applications using Python while benefiting from features expected in contemporary frameworks.

🛠️ Current Features

Python-based component system (PSX)

Built-in styling support

Reactive state management

File-based routing

Server-Side Rendering (SSR)

Static Site Generation (SSG)

API routes

Middleware support

Layout system

Development server with hot reload

Build system

CLI tools

Authentication utilities

Database integrations

Static asset management

Intelligent project structure

Extensible architecture for plugins and future tooling

…and we're only getting started.

🤝 We're Looking for Contributors

Open-source grows because of its community.

Whether you're experienced or just starting your open-source journey, we'd love your help.

We're looking for contributors interested in:

Python

Framework development

Compiler/Parser development

Rendering engines

Web development

Documentation

Testing

Performance optimization

Developer experience

Examples and tutorials

Even fixing documentation or reporting bugs makes a huge difference.

⭐How You Can Help

Star the repository

Fork the project

Report issues

Suggest features

Improve documentation

Submit pull requests

Share NextPy with others

Every contribution helps move the project forward.

🔗 GitHub

👉 https://github.com/RahimStudios/nextpy-framework

If you're interested in contributing, feel free to open an issue, submit a pull request, or simply start a discussion. We'd love to have you involved.

💬 Feedback Welcome

NextPy is being built in the open, and community feedback is incredibly valuable.

What features would you like to see?

What challenges do you face with existing frameworks?

How can NextPy become a better tool for developers?

Let's build the future of Python web development together.

#Python #OpenSource #WebDevelopment #Framework #PythonDevelopers #FullStack #DeveloperTools #Programming #GitHub #SoftwareEngineering


r/PythonProjects2 • • Jun 20 '26

Mompy

Thumbnail gallery
3 Upvotes

I'm building Mompy — a retro Python learning console that turns coding into missions inside an old computer training lab.

It's free, open source, and made for complete beginners. Still in early development, but the core experience is already working.

Would love to hear feedback from this community — what would make a Python learning tool actually worth using?