https://github.com/psincraian/myfy
https://github.com/psincraian/myfy
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/psincraian/myfy
- Owner: psincraian
- Created: 2025-10-24T19:23:37.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2026-01-10T20:45:25.000Z (6 months ago)
- Last Synced: 2026-01-11T02:43:41.158Z (6 months ago)
- Language: Python
- Size: 4.11 MB
- Stars: 83
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
Awesome Lists containing this project
README
# myfy
[](https://pepy.tech/projects/myfy-core)
**Build Python applications with FastAPI's ergonomics and enterprise-grade architecture.**
A modern Python framework combining type-safe dependency injection, modular architecture, and sensible defaults—all in a lightweight, async-first design.
---
## Quick Start
### Installation
```bash
# Install with uv (recommended)
uv pip install myfy-core myfy-web myfy-frontend myfy-cli
# Or with pip
pip install myfy-core myfy-web myfy-frontend myfy-cli
```
### Hello World
```python
# app.py
from myfy.core import Application
from myfy.web import route, WebModule
from myfy.frontend import FrontendModule
@route.get("/api/hello/{name}")
async def hello(name: str) -> dict:
return {"message": f"Hello {name}!"}
app = Application(auto_discover=False)
app.add_module(WebModule())
app.add_module(FrontendModule())
```
**Run it:**
```bash
uv run myfy run
# API: http://127.0.0.1:8000/api/hello/World
# Frontend: http://127.0.0.1:8000
```
---
## Key Features
- **Type-Safe Dependency Injection** - Constructor injection with compile-time validation
- **Modular Architecture** - Composable modules with lifecycle management
- **FastAPI-Style Routes** - Decorators, type hints, and async/await
- **Zero Config** - Sensible defaults, configure only what you need
- **Profile-Based Settings** - Environment-aware configuration (dev/test/prod)
---
## Documentation
**[📖 Full Documentation at myfy.dev →](https://myfy.dev)**
- [Getting Started](https://myfy.dev/getting-started/installation/) - Installation and tutorial
- [Core Concepts](https://myfy.dev/core-concepts/dependency-injection/) - DI, modules, and lifecycle
- [Guides](https://myfy.dev/guides/building-modules/) - Building modules and deployment
- [API Reference](https://myfy.dev/api-reference/core/) - Complete API docs
---
## Claude Code Plugin
myfy includes a [Claude Code plugin](https://code.claude.com/docs/en/discover-plugins) for AI-assisted development. Install the plugin to get:
- **Skills** for common myfy patterns (routing, DI, modules)
- **Agents** for scaffolding new projects and components
- **Commands** for common operations
```bash
# Add the myfy marketplace
/plugin marketplace add psincraian/myfy
# Install the plugin
/plugin install myfy@psincraian-myfy
```
---
## Learn More
- [Examples](examples/) - Working applications in this repo
- [PRINCIPLES.md](PRINCIPLES.md) - Design philosophy and architecture decisions
---
## License
MIT