Welcome! Pythonic is a modern C++20 library that brings the expressive power and clean syntax of Python to C++. It aims to make C++ code feel as natural and productive as Python, while retaining the performance and flexibility of C++.
Pythonic is a C++ library designed for developers who love Python's dynamic features but need the speed and control of C++. It provides:
- Dynamic typing and flexible containers
- Python-style slicing, comprehensions, and string methods
- Easy-to-use data structures (list, dict, set, etc.)
- Graph algorithms and interactive graph visualization with ImGui
- Terminal media rendering (images and videos in braille or true color)
- Math utilities and more
- A familiar, readable syntax—no weird hacks, just clean C++
- Write C++ code that feels like Python—concise, readable, and expressive
- Rapid prototyping and algorithm development in C++
- Seamless integration with modern C++ projects
- Great for teaching, competitive programming, and research
#include<pythonic/pythonic.hpp>usingnamespacepythonic::vars;usingnamespacePythonic;intmain() {
// Python-style dynamic variables
var x = 42;
var name = "Alice";
var data = list({1, 2, 3, 4, 5});
print("Hello,", name, "! Sum:", sum(data));
// Terminal plottingpythonic::plot::plot([](double x) { returnsin(x); }, -3.14, 3.14);
// Print images/videos in terminalprint("photo.png"); // Displays image as braille artprint("video.mp4"); // Plays video in terminalreturn0;
}- Getting Started Guide — Complete step-by-step guide on cloning, building, installing, and using this library (includes all optional dependencies)
- API Documentation — Detailed user guide for all features
The library includes several optional features that can be enabled during build:
| Feature | Description | CMake Flag | Dependencies |
|---|---|---|---|
| Graph Viewer | Interactive graph visualization with ImGui | -DPYTHONIC_ENABLE_GRAPH_VIEWER=ON | GLFW, OpenGL, ImGui |
| Audio Playback | Synchronized audio for video playback | -DPYTHONIC_ENABLE_SDL2_AUDIO=ON | SDL2 or PortAudio |
| GPU Rendering | GPU-accelerated video rendering | -DPYTHONIC_ENABLE_OPENCL=ON | OpenCL |
| OpenCV Support | Webcam capture & advanced processing | -DPYTHONIC_ENABLE_OPENCV=ON | OpenCV |
Note: All features are optional. The core library works without any of these dependencies. See the Getting Started Guide for detailed installation instructions for each feature.
# Clone the repository
git clone https://github.com/Creamy-pie-96/Pythonic.git
cd Pythonic
# Build and install (core features only)
mkdir build &&cd build
cmake .. -DCMAKE_INSTALL_PREFIX=../install
cmake --build . --target install
# Use in your project's CMakeLists.txt
find_package(pythonic REQUIRED)
target_link_libraries(your_target pythonic::pythonic)For detailed installation with optional features, see the Getting Started Guide.
ScriptIt is a dynamic scripting language built on top of Pythonic's var system, with a full VS Code extension, notebook support, and color customizer. See the ScriptIt Language Guide for full documentation.
See CONTRIBUTING.md for guidelines on how to contribute to this project.
This project is licensed under the MIT License - see the LICENSE file for details.
We’re looking for users to test the library and provide feedback! Please open Issues or Discussions with any bug reports, questions, or feature ideas. Note: Direct code contributions are not accepted at this time.
Parts of this project, including some code generation and much of documentation, were assisted by GitHub Copilot (AI programming assistant). Copilot provided suggestions and support throughout the development process.
AUTHOR: MD. NASIF SADIK PRITHU GITHUB:Creamy-pie-96