# brython
**Repository Path**: mirrors/brython
## Basic Information
- **Project Name**: brython
- **Description**: Brython 设计用于替换网页上的 JavaScript 脚本语言，它使用 Python 来编写脚本，并直接在网页上执行
- **Primary Language**: Python
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: https://www.oschina.net/p/brython
- **GVP Project**: No
## Statistics
- **Stars**: 5
- **Forks**: 4
- **Created**: 2020-06-19
- **Last Updated**: 2025-11-22
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
brython
=======
Brython (Browser Python) is an implementation of Python 3 running in the
browser, with an interface to the DOM elements and events.
Here is a simple example of an HTML page running Python:
```html
```
To use Brython, all there is to do is:
1. Load the script [brython.js](http://brython.info/src/brython.js "Brython from the site brython.info").
2. Write Python code inside tags `
```
The previous code will allow you to use raw python code, but if you import
modules from the standard library you have to load a single javascript file
with the [available stdlib](https://github.com/brython-dev/brython/tree/master/www/src/Lib):
```html
```
jsDelivr supports version ranges, so if you want the latest of the
3.14.x versions:
```html
```
or the latest of the 3.x.y versions:
```html
```
If you want to use the latest development version, you can load these scripts
instead:
```html
```
Local install
-------------
To install Brython locally, if you have a CPython distribution with `pip` :
```bash
pip install brython
```
then create a new directory and run
```bash
brython-cli install
```
or by loading the latest version of the Brython zip file from the
[releases page](https://github.com/brython-dev/brython/releases).
In both cases, the distribution includes __brython.js__ (the core Brython engine)
and __brython_stdlib.js__ (a bundle of all the files in the standard distribution).
It also includes the page __demo.html__ that shows a few examples of how you
can interact with a web page using Python as the scripting language : create
new elements, access and modify existing elements, create graphics, animations,
send Ajax requests, etc.
Test Brython online
===================
If you want to test Brython online you can visit the following:
- [Editor](http://brython.info/tests/editor.html "Online Brython Editor")
- [Console](http://brython.info/tests/console.html "Online Brython Console")
Gallery of examples
===================
There is a [gallery of examples](http://brython.info/gallery/gallery_en.html "gallery of examples")
where you can see simple and advanced examples using vanilla Brython or
interacting with Javascript libraries.
Documentation
=============
You can start by reading the official [Brython tutorial](https://brython.info/static_tutorial/en/index.html).
Full documentation is available on the [official site](http://www.brython.info "Brython Homepage").
You can read the docs in [English](http://brython.info/static_doc/en/intro.html) and
[French](http://brython.info/static_doc/fr/intro.html).
Curious about [how Brython works](https://github.com/brython-dev/brython/wiki/How%20Brython%20works) ?
A [tutorial](https://github.com/brython-dev/brython/wiki/Writing-an-Android-application)
explains how to build Android applications with Brython.
You can also [Ask Brython Guru](https://gurubase.io/g/brython), it is a Brython-focused AI to answer your questions.
Community (questions, feedback, issues, new features, ...)
==========================================================
You can subscribe and post to the
[mailing list](https://groups.google.com/forum/?fromgroups=#!forum/brython "Brython Main Mailing List").
If you find a bug/issue or do you want to see a new feature in Brython, please,
[open a new issue](https://github.com/brython-dev/brython/issues "Brython GitHub Issues").
If you want to contribute to Brython, please read the [contributing guide](https://github.com/brython-dev/brython/blob/master/CONTRIBUTING.md).
Thank you
=========
- [BrowserStack](http://www.browserstack.com) for providing an access
to their online testing environment.