Complete Offline Learning Package

⚖ MIT License — Open Source

Created by Dinesh Kumar Alagusundaram

Python for
Rhino & Grasshopper

Everything you need to master Python scripting in Rhino — drawn from the official Primer, RhinoScript101, and the complete live API. Reads offline, no internet needed.

▶ Start Learning ⚙ API Reference ⚡ Cheatsheet

Content sourced from

Python Primer for Rhino — Tibbits / van der Harten / Baer (2011, Rev 3)

RhinoScript Primer 101 — D. Rutten / Robert McNeel & Associates

RhinoScriptSyntax Live API — developer.rhino3d.com (offline snapshot)

Rhino.Geometry (RhinoCommon) — .NET geometry SDK

Curriculum

12 Chapters, Zero to Expert

Each chapter builds on the last — from Rhino macros to full NURBS geometry scripting. Real code from the official primers throughout.

What is Scripting?

Macros vs Scripts vs Programs. The EditPythonScript editor. Running your first line of code.

macroseditorRunPythonScript

Python Essentials

Variables, all data types, naming conventions, indentation, case sensitivity, flow control.

intfloatstrboolNone

Brackets Decoded

All three bracket types: parentheses for calls, square for lists/indexing, curly for dicts.

( )[ ]{ }slicing

Operators & Functions

All operator types, precedence, def / return, default args, variable scope, mutability.

+−×÷defreturnscope

if / elif / else chains. Boolean logic with Venn diagrams. Rhino object classification examples.

ifelifelseandornot

while and for loops. Sine wave example. Sphere distribution with nested loops. break / continue.

forwhilerange()breakfrange

Lists, Tuples, Dicts

All container types with methods, list comprehensions, nested lists, mutability deep dive.

listtupledictmutable[ : ]

Object-Oriented Programming: __init__, self, inheritance, polymorphism, isinstance().

class__init__selfinherit

Geometry Deep Dive

Points, vectors, lines, planes, circles (Rusin algorithm), NURBS, surfaces, meshes, parameter spaces.

Point3dNURBSSurfaceMeshR1/R2/R3

Imports & Modules

All four import forms. rs vs rg, ghpythonlib, System.Drawing. Complete GHPython template.

rsrgghcompmathrandom

The Rhino debugger: breakpoints, step controls, variable pane. Common errors and fixes.

breakpointsteptry/excepterrors

Grasshopper Python

GHPython setup, inputs/outputs, DataTree, rs vs rg in GH. Full point grid and facade examples.

GHPythonDataTreeaccesscolor

Strings Deep Dive

All string methods, slicing, f-strings with format specifiers, .format(), raw strings, escape chars.

f-string.split().join()slicezfill

try/except/else/finally. All exception types. Raising custom exceptions. Defensive Rhino patterns.

tryexceptraiseValueErrorfinally

Read/write txt files, with statement, JSON save/load, os.path, save script settings pattern from Primer.

open()withjsonos.pathreadlines

Advanced Python

lambda, *args/**kwargs, generators with yield, advanced list/dict/set comprehensions, map/filter.

lambda*argsyieldgeneratormap

RhinoCommon (rg.)

Point3d, Vector3d, Plane, Line, Transform, NurbsCurve, Brep. rs. vs rg. comparison. GH geometry.

Point3dVector3dNurbsCurveBreprg.

Parametric Patterns

Attractor fields, mesh from f(x,y), parametric tower, GH DataTrees, the 5 parametric principles.

attractormeshtowerlerpnormalize

API Reference — Offline

RhinoScriptSyntax — 26 Categories

Complete offline copy of the official Rhino Python API, organized by function category. Click any card to jump to its section.