https://github.com/europanite/standard_python_environment

A Standard Python Container.
https://github.com/europanite/standard_python_environment

container cross-platform docker docker-compose education jupyter jupyterlab lint linux macos pip pylint pytest python python-console python-container template windows x11

Last synced: 7 days ago
JSON representation

A Standard Python Container.

• Host: GitHub
• URL: https://github.com/europanite/standard_python_environment
• Owner: europanite
• License: apache-2.0
• Created: 2025-08-30T00:43:44.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2025-12-31T05:08:16.000Z (4 months ago)
• Last Synced: 2026-04-11T11:39:31.666Z (7 days ago)
• Topics: container, cross-platform, docker, docker-compose, education, jupyter, jupyterlab, lint, linux, macos, pip, pylint, pytest, python, python-console, python-container, template, windows, x11
• Language: Python
• Homepage: https://europanite.github.io/standard_python_environment/
• Size: 403 KB
• Stars: 4
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md

Awesome Lists containing this project

README

          
# [Standard Python Environment](https://github.com/europanite/standard_python_environment "Standard Python Environment")

[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

[![Python](https://img.shields.io/badge/python-3.9|%203.10%20|%203.11|%203.12|%203.13-blue)](https://www.python.org/)

![OS](https://img.shields.io/badge/OS-Linux%20%7C%20macOS%20%7C%20Windows-blue)

[![CI](https://github.com/europanite/standard_python_environment/actions/workflows/ci.yml/badge.svg)](https://github.com/europanite/standard_python_environment/actions/workflows/ci.yml)

[![Python Lint](https://github.com/europanite/standard_python_environment/actions/workflows/lint.yml/badge.svg)](https://github.com/europanite/standard_python_environment/actions/workflows/lint.yml)

[![Pytest](https://github.com/europanite/standard_python_environment/actions/workflows/pytest.yml/badge.svg)](https://github.com/europanite/standard_python_environment/actions/workflows/pytest.yml)

[![pages-build-deployment](https://github.com/europanite/standard_python_environment/actions/workflows/pages/pages-build-deployment/badge.svg)](https://github.com/europanite/standard_python_environment/actions/workflows/pages/pages-build-deployment)

[![CodeQL Advanced](https://github.com/europanite/standard_python_environment/actions/workflows/codeql.yml/badge.svg)](https://github.com/europanite/standard_python_environment/actions/workflows/codeql.yml)

![Python](https://img.shields.io/badge/python-3670A0?logo=python&logoColor=ffdd54)

![Pytest](https://img.shields.io/badge/pytest-%23ffffff.svg?logo=pytest&logoColor=2f9fe3)

![Jupyter Notebook](https://img.shields.io/badge/jupyter-%23FA0F00.svg?logo=jupyter&logoColor=white)

A standard **Python** environment built with **Docker Compose**.

!["image"](./assets/images/image.png)

---

## Features

- **Reproducibility**: Dependencies are locked inside the container

- **Simplicity**: Run with just docker compose commands

- **Portability**: Works on Linux, macOS, and Windows

- **pip ready**: Install and manage Python packages easily

- **JupyterLab support**: (Optional) Run notebooks inside the container

- **X11 forwarding**: (Optional) Run GUI-based Python apps

---

## Requirements

- [Docker Compose](https://docs.docker.com/compose/)

---

## Getting Started

### Linux

```bash

# Clone this repository

git clone https://github.com/europanite/standard_python_environment.git

cd standard_python_environment

# Export host UID/GID

export HOST_UID=$(id -u) 

export HOST_GID=$(id -g)

# Build and run

docker compose build

docker compose up -d

docker compose exec service bash

```

### Windows

```powershell

# Clone this repository

git clone https://github.com/europanite/standard_python_environment.git

cd standard_python_environment

# Build and run

docker compose build

docker compose up -d

docker compose exec service bash

```

Now you are inside the Python container 🎉

If you use JupyterLab, just you need to access http://localhost:8888

---

### Test

```bash

# pytest

docker compose \

-f docker-compose.test.yml run \

--rm \

--entrypoint /bin/sh service_test \

-lc 'pytest'

# Lint

docker compose \

-f docker-compose.test.yml run \

--rm \

--entrypoint /bin/sh service_test \

-lc 'ruff check /app /tests'

```

## License

- Apache License 2.0