Skip to content

Latest commit

 

History

23 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

VisualPy

PyPI version Downloads Python versions License GitHub stars

VisualPy is a modern, cross-platform interactive Python console featuring real-time syntax highlighting, autocompletion, import suggestions, and live code hints. Designed as a lightweight alternative to IPython and bpython, it runs seamlessly on both CPython and PyPy runtimes.

Features

  • Real-Time Syntax Highlighting: Powered by Pygments with support for dark and light background themes.
  • Autocompletion & Tooltips: Code hints for built-ins, standard libraries, and imported modules.
  • Dual Runtime Support: Full compatibility with both CPython and PyPy.
  • Cross-Platform Clipboard Integration: Effortless code snippet copying and pasting.
  • Configurable Lexers: Custom terminal cursor styles and multiple syntax lexer options.

Installation

Via PyPI

pip install VisualPy -U

Via Poetry

poetry add VisualPy

Quick Start

Launch the interactive shell using the installed command-line utility or Python module runner:

vpy

Or via python executable:

python -m vpy

Command-Line Arguments

usage: vpy [-h] [-dbg]
           [-lex {PythonLexer,PythonConsoleLexer,PythonTracebackLexer,Python2Lexer,Python2TracebackLexer,CythonLexer,DgLexer,NumPyLexer}]
           [-t-lex {PythonLexer,PythonConsoleLexer,PythonTracebackLexer,Python2Lexer,Python2TracebackLexer,CythonLexer,DgLexer,NumPyLexer}]
           [-cr CURSOR] [-i INTERACT_IT] [-q]

optional arguments:
  -h, --help            Show this help message and exit

Highlight Options:
  -dbg, --darkbg        Adapt syntax colors for dark terminal backgrounds

Lexer Options:
  -lex, --lexer         Select primary syntax lexer (default: PythonLexer)
  -t-lex, --traceback-lexer
                        Select lexer for traceback formatting (default: PythonTracebackLexer)
  -cr, --cursor         Set custom interactive prompt cursor string

Python Options:
  -i, --interact-it     Inspect environment interactively after running script
  -q, --quiet           Suppress startup version and copyright banner

Screenshots

Interactive Console

Interactive Console Options Showcase

CPython Environment

CPython Runtime

Auto-Completion & Import Hints

Import Hints Import Completion

Themes

Dark Theme (Default)

Dark Theme

Light Theme (--darkbg flag)

Light Theme

License

Distributed under the MIT License. See LICENSE for more details.

Author

Created and maintained by Nikita Denissov (@ndenissov).

About

VisualPy is a modern, cross-platform interactive Python console and REPL. Designed as a lightweight alternative to IPython, it features real-time syntax highlighting, autocompletion, and live code hints. Compatible with CPython and PyPy, it offers customizable lexers and themes to enhance your terminal development workflow.

Topics

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages