https://github.com/pkeffect/python-framework

A production-ready Python project generator that creates complete project structures using only the Python standard library. No pip install, no virtual environments needed to run—just Python.
https://github.com/pkeffect/python-framework

cli cross-platform framework gui python

Last synced: 2 months ago
JSON representation

A production-ready Python project generator that creates complete project structures using only the Python standard library. No pip install, no virtual environments needed to run—just Python.

• Host: GitHub
• URL: https://github.com/pkeffect/python-framework
• Owner: pkeffect
• License: mit
• Created: 2026-01-17T22:05:34.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2026-01-17T23:28:32.000Z (3 months ago)
• Last Synced: 2026-01-18T10:42:26.737Z (3 months ago)
• Topics: cli, cross-platform, framework, gui, python
• Language: Python
• Homepage: https://internode.info/
• Size: 179 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Audit: AUDIT.md
  • Codeowners: .github/CODEOWNERS
  • Security: SECURITY.md
  • Support: SUPPORT.md

Awesome Lists containing this project

README

          
# Internode Bare Metal Framework

> **Single-file, zero-dependency Python project generator**

[![CI](https://github.com/pkeffect/python-framework/actions/workflows/ci.yml/badge.svg)](https://github.com/pkeffect/python-framework/actions/workflows/ci.yml)

[![Release](https://github.com/pkeffect/python-framework/actions/workflows/release.yml/badge.svg)](https://github.com/pkeffect/python-framework/releases)

[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[![No Dependencies](https://img.shields.io/badge/dependencies-none-green.svg)]()

[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)

[![Security: bandit](https://img.shields.io/badge/security-bandit-yellow.svg)](https://github.com/PyCQA/bandit)

A production-ready Python project generator that creates complete project structures using **only the Python standard library**. No pip install, no virtual environments needed to run—just Python.

![Internode Python Framework UI](./images/firefox_fJLSai4HOg.png)

## ✨ Features

- 🐍 **Zero Dependencies** - Uses only Python stdlib

- 📄 **Single File** - One `.py` file, ~2000 lines

- 🎨 **Dual GUI** - Tkinter native + Web UI fallback

- 📦 **5 Templates** - default, minimal, api, cli, library

- 🔌 **Plugin System** - Extensible via `~/.internode/plugins/`

- ⚙️ **Config File** - User defaults in `~/.internode.toml`

- 🔄 **Update Mode** - Add missing files to existing projects

## 🚀 Quick Start

```bash

# Clone or download

git clone https://github.com/pkeffect/python-framework.git

cd python-framework

# Generate a project

python python_framework.py --name MyProject

# Or use the GUI

python python_framework.py --gui

# Or use the web-based GUI

python python_framework.py --gui2

```

## 📋 Usage

```bash

# Basic generation

python python_framework.py --name MyApp

# With options

python python_framework.py --name MyApp --template minimal --no-venv

# Interactive mode

python python_framework.py --interactive

# Preview without creating files

python python_framework.py --name TestProject --dry-run

# Update existing project

python python_framework.py --name ExistingProject --update

# GUI modes

python python_framework.py --gui   # Tkinter (with web fallback)

python python_framework.py --gui2  # Web UI directly

```

## 📁 Generated Structure

```

MyProject/

├── .github/workflows/ci.yml

├── .pre-commit-config.yaml

├── .gitignore

├── configs/

│   └── config.json, config.yaml, config.toml, config.ini

├── docs/

│   └── CODE_OF_CONDUCT.md, CONTRIBUTING.md, SUPPORT.md, ...

├── src/myproject/

│   └── __init__.py, main.py, utils.py

├── tests/

│   └── __init__.py, test_main.py

├── .venv/ (optional)

├── Dockerfile

├── LICENSE

├── manage.py

├── pyproject.toml

└── README.md

```

## 🎨 Templates

| Template | Description |

|----------|-------------|

| `default` | Full-featured with configs, tests, and documentation |

| `minimal` | Bare minimum: src, README, LICENSE only |

| `api` | API project with configs and tests |

| `cli` | CLI tool project |

| `library` | Reusable library package |

## ⚙️ Configuration

Create `~/.internode.toml` for user defaults:

```toml

author = "@pkeffect"

email = "your-email@example.com"

template = "default"

```

## 🔌 Plugins

Create plugins in `~/.internode/plugins/`:

```python

# ~/.internode/plugins/my_plugin.py

def register():

    return {"name": "My Plugin", "version": "1.0"}

def post_generate(generator):

    print(f"Generated: {generator.project_name}")

```

## 📄 License

MIT License - see [LICENSE](LICENSE)

## 👨‍💻 Author

**pkeffect** - [GitHub](https://github.com/pkeffect)