Skip to main content

The graphics framework used by CMU CS Academy, geared toward beginner CS students.

Project description

Desktop CMU Graphics logo

Desktop CMU Graphics is an offline version of CMU Graphics, a persistent-object graphics package geared towards beginner computer science students. CMU Graphics and its desktop version are maintained by CMU CS Academy, a Carnegie Mellon University project which develops free-to-use middle and high school computer science curriculum.

Desktop CMU Graphics works with Python 3.6-3.10 and is compatible with Replit and Coding Rooms (see the "Replit" and "Coding Rooms" sections below). This package, including its documentation, is licensed under the BSD 3-Clause license.

Installation

Choose zip or pip

There are two different ways to install Desktop CMU Graphics on a device:

  1. (Mac and Windows only) Use the zip file installer that is available for download on the CMU CS Academy website.
  2. (Mac, Windows, and Linux) Use pip, Python’s built-in package-managing software.

Both methods come with their own advantages and limitations. If you're in doubt about which to choose, the zip file installer is the most likely to succeed. It should work regardless of most restrictions in place on school-distributed devices.

For those using devices with Linux operating systems, or for those who are familiar with the command line/terminal, the pip version of the package offers a larger degree of versatility.

The remainder of these installation instructions are only for the pip version.

Install dependencies

If you're using Windows, you don't need to install any dependencies. Skip ahead to "Install CMU Graphics" below.

If you're using a Mac, install Homebrew.

If you're using a Mac or Linux, install the software packages needed by pycairo. Read their getting started page for instructions.

Install CMU Graphics

Run the following command:

pip install cmu-graphics

Getting Started

To run our graphics framework, include the following line at the top of your Python file:

from cmu_graphics import *

At the end of your Python file, add this line:

cmu_graphics.run()

From there, the syntax for using the graphics package is identical to the online version of the framework. You can find more details about how to use the graphics framework here on our documentation page.

Teacher Support and Documentation

If you are a teacher with a CMU CS Academy Account and you have questions about CMU Graphics, remember that you can reach out to us through the Support tab on the left side of the CMU CS Academy website:

Highlighted teacher support tab

If you are an educator but do not have an account with CMU CS Academy, you can register for an account here.

If you are a student, or you are exploring Desktop CMU Graphics, there are plenty of resources to help you get started with the framework. Students can reach out to their teachers for questions about CMU Graphics, and a full reference documentation for the graphics framework is available on our documentation page.

Replit

Desktop CMU Graphics is compatible with Replit. To use the package on the Replit website:

  1. Create a new repl. Choose "Pygame" as the language.
  2. Click on the cube menu icon "Packages".
  3. Type "cmu-graphics" into the search bar, click on the package, and then click "Add".
  4. Run your code!

Coding Rooms

Desktop CMU Graphics is compatible with Coding Rooms. To use the package on the Coding Rooms website:

  1. Visit this link to create a workspace
  2. Click "Start Coding Python for Free Now"
  3. Click the blue "View Desktop" button above the shell
  4. Run your code!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cmu-graphics-1.1.15.tar.gz (62.9 kB view details)

Uploaded Source

Built Distribution

cmu_graphics-1.1.15-py3-none-any.whl (65.9 kB view details)

Uploaded Python 3

File details

Details for the file cmu-graphics-1.1.15.tar.gz.

File metadata

  • Download URL: cmu-graphics-1.1.15.tar.gz
  • Upload date:
  • Size: 62.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.9.5

File hashes

Hashes for cmu-graphics-1.1.15.tar.gz
Algorithm Hash digest
SHA256 232abf486acd736dc4aa9fc88364a686100ad932f624dc54791aa12a309ec273
MD5 c7734ee1eb31cc1279d9f7e2aa3b864d
BLAKE2b-256 5beea2e6c920b43fafc6492251c6d2e2840fc504d113d8ed06b9663d65696135

See more details on using hashes here.

File details

Details for the file cmu_graphics-1.1.15-py3-none-any.whl.

File metadata

File hashes

Hashes for cmu_graphics-1.1.15-py3-none-any.whl
Algorithm Hash digest
SHA256 f533fb11e3ab4dfec3525c5dc78bc2888f37f404454f0c178445d84eb7dc8efc
MD5 8dc82facfb49ba0f3c90804908bd6d70
BLAKE2b-256 5c65256a91c2021b608a4debe3389e082c7a837ae43d107afb0229afe49cc246

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page