hackclub/blot is a JavaScript project with 347 stars. 🤖 ✍️ blot, the plotting bot from hack club
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Saw Blot at RMRRF 2026? That was a fork of the firmware, check it out here.
Create programmatic art in our web-based editor and submit it to the gallery and we'll send you a CNC machine which can make that art for free.
Blot is a You Ship, We Ship project from Hack Club.
Everything about Blot is open source. The online editor and drawing library can be freely used by anyone, and we encourage all to submit to the gallery through PRs! However, you must be a teenager or younger to receive a free machine.
A piece of art made for Blot can be the first program you ever write, but it can also be a challenge for a master programmer. Check out some of the art made already in our gallery. Every piece of art you see is actually a program. Many of them create unique pieces every time the art is run. You may be looking at an artwork which has never been seen before, even by the creator.
For a short video introduction to Blot check out our 38 second trailer.
How It Works
1) Create a piece of programmatic art in the web editor.
To learn the Blot drawing library follow our getting started guide. Check out the examples in the gallery and then follow along with some of our guides.
2) Submit that art to the public gallery.
The submission rules to get a Blot for a PR are here. You must be a teenager (or younger to qualify for a free machine) but anyone can make art and make a PR.
3) Receive the parts to build your own Blot that can draw that art in real life.
The bill of materials can be found here and an assembly guide here.
Blot is...
A custom CNC drawing machine designed from scratch to introduce you to digital fabrication.
It's made of 6 unique 3D printed parts with a custom control board and easy to understand firmware, which can be interfaced with through JavaScript in the browser.
Blot is designed in OnShape. Check out the 3D model of the project.
You can find the bill of materials here and, if you'd like to 3D print your Blot, the parts are here. The entire build costs about $150 dollars. If you're a teen we will give you all the parts for a PR with your an art piece you coded yourself.
A web based editor for programmatic art that we designed specifically for pen plotting with a custom geometry library.
We practiced programmatic pen plotting with some amazing artists.
There is so much to learn and explore on the programming and the aesthetic side.
Blot Docs
Here are a collection of resources for Blot:
Complete documentation of the drawing library in the editor
Short documentation shown in the Blot editor
The Blot assembly and operation guide
The source of truth bill of materials (BOM)
Criteria for how to get a Blot and a guide on how to submit a PR
A guide on how to review Blot submissions
A brief guide on how to approve Blot requests for Blot shipments
Information on how we order Blot supplies from our manufacturing partners
The files for the 3D printed parts
The source files for the control PCB
The source files for the power delivery PCB
The firmware for the Blot control board
Sample Blot based lesson plan
Video of a Blot being assembled
Video of operating a Blot
Video of making a Blot submission
Video Blot promo trailer
Video introduction to JavaScript in the context of Blot
Video introduction to Blot editor
Video demonstrating working through a Blot guide
What are People Making with Blot
Blot has been in development since January 2023 and was released April 2024. We've had lots of people use the Blot editor and the Blot machine to create visual art, run workshops and as part of interactive installations. Here's a sense of what can be done with Blot.
Programmatic Art
There are all sorts of styles of programmatic art. Here are some examples of great Blot submissions that show a range of styles. This list is by no means exhaustive.
The natural scene is a common source of artistic inspiration. This could be called figurative or representational art when it tries to depict a real thing with some fidelity. One example are these roots by Kai (age 17).
The geometric pattern is natural avenue to pursue when making art with computers because code is a great way to describe patterns. Oz's approach of clipping overlapping segments creates a wonderful sense of depth.
The tech demo (with composition) is focusing on a specific technical approach like in Henry's (age 15) ray marcher. The art piece isn't complete though until the artists uses the technique to make a composition.
The data transformation can be seen in Kieran's (age 15) self portrait. It takes data from an SVG but modifies it programmatically to produce an art piece. This approach could be used to visualize data that may not of been visual to begin with.
The concept is important with any artwork and can be mixed with any of the genres above. Ultimately an interesting idea can be what elevates something that is visually pretty simple, one example by Ayush is the Blot's own self portrait.
For way more examples check out the gallery.
Blot as Creative Material
You ship we ship projects are developed to provide technological creative material. The Blot was developed to not just create visual programs on computers but also to explore robotic and interactive technology. Here are some ways the machine or project has been used to create interactive technology experiences.
Lineflow was developed as an interactive art piece for an MIT Museum event. Participants would create a single line drawing on the computer and would then watch a simulation of a line folding into their drawing. Three frames of that simulation were strung together to create a timeline of the animation that would be drawn by a Blot to be brought home by the participant.
The infinite gallery at Outernet (Hack Club's 2023 summer hackathon). Leo, Kai, and Henry constructed a black out box that contained an infinite art gallery. Participant's entered a room sized black box with one wall illuminated with artwork and a giant joystick in the center. They could navigate the gallery with the joystick and as they explored new (possibly never before seen) art was generated based on their location.
Chinese calligraphy workshop was developed for and run at the Hack Club leader summit 2024 by Bright Li (age 15). During it participants learned how to draw Chinese calligraphy programmatically and then handed ink brushes to Bright's Blot robot to put the drawings to the page.
It's All Open Source
Every part of Blot is freely available for you to investigate and discover.
That includes the editor, the hardware design, the electronics, and even the finances around the project.
We think people deserve tools they can take ownership of. That's why we give away the source for free.
Our projects at Hack Club have hundreds of teenage contributors from all over the world. If you want to learn how to program, we invite you to jump in and start building tools used by thousands.
You're also welcome to participate and use our tools if you aren't a teen (like making art or building your own blot), but our online community is for teens only.
You Ship, We Ship
At Hack Club we're reimagining a new type of public education for technology. We believe people learn best by creating things they care about and sharing them with others. We build open source creative tools with young people all around the world. These tools are gateways to new subjects in technology like embedded systems, circuits or digital fabrication robotics. When teenagers build things with our tools we send them more creative materials for free.
Our goal is to build a new type of library online that offers learners not just media to consume but tools to create. And it is free and open source to all. We're just getting started...
Development
Join the #blot channel on the Hack Club Slack.
The Blot editor is run with an Express server.
After installing Git, Node.js, and Yarn, clone the repo.
The Hack Club Blot is open source and licensed under the MIT License. Fork, remix, and make it your own! Pull requests and other contributions greatly appreciated.
Acknowledgements
Many people have contributed to Blot, to mention a few and give much thanks too...
MIT's Center for Bits and Atoms for providing expert advice and occasionally a space to work.
Sam Hu and his team at ISourceAsia for supplying Blot parts and becoming a critical part of the Blot team.
Paul Hamilton for his contributions to embedded circuit designs.
Oz Nova for writing an excellent getting started guide.
The most recent commit recorded on hackclub/blot was 1 month ago, based on the GitHub push timestamp. The repository has 475 forks — one of the better signals of community interest.
How many stars does hackclub/blot have?
hackclub/blot has 347 GitHub stars — refresh the page for the live number, or check github.com/hackclub/blot. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is hackclub/blot open source?
Yes — hackclub/blot ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/hackclub/blot.
What is hackclub/blot?
hackclub/blot (hackclub/blot) is a JavaScript project on GitHub. From the project's own README: 🤖 ✍️ blot, the plotting bot from hack club
What language is hackclub/blot written in?
hackclub/blot is written primarily in JavaScript. GitHub's language field is based on the largest share of bytes in the default branch.
What license does hackclub/blot use?
hackclub/blot is released under the MIT license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
Where do I read more about hackclub/blot?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/hackclub/blot is the definitive source.
Read full README in the tab above.
Is blot worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of blot.
