The official GitHub for SPECS
Where you can find the best projects to start your AR developer journey. Let's build the future.
Before you begin developing for SPECS, make sure you have the required tools installed:
Required Software:
- Lens Studio - Snap's free AR development platform for creating SPECS experiences
- Companion App (Android) - Companion app for Android devices
- Companion App (iOS) - Companion app for iOS devices
SPECS is the official GitHub organization for SPECS development resources. We provide open-source tools, frameworks, templates, and comprehensive documentation to help developers build amazing AR experiences for SPECS.
Important
Spectacles (2024) is supported only on 5.15.4. Use the 5.15.4 branch / release of each repo.
Everything 5.22.0+ targets SPECS 27. Redirect links here assume main (5.22.0+) and won't work with Spectacles (2024).
Whether you're creating your first AR lens or developing complex spatial applications, we offer the resources and community support you need to succeed.
Ready-to-use project templates and sample applications demonstrating SPECS capabilities. Clone individual projects using sparse checkout:
| Preview | Title | Description | Clone Command |
|---|---|---|---|
 |
AI Playground | Sample project for AI in using Specs Remote Service Gateway. | git clone --filter=blob:none --sparse https://github.com/specs-devs/samples.git |
 |
Crop | Sample project showing how to "crop" the environment using hand gesture. | git clone --filter=blob:none --sparse https://github.com/specs-devs/samples.git |
 |
Depth Cache | Cache depth frames for pixel-to-3D projection with cloud-based vision models. | git clone --filter=blob:none --sparse https://github.com/specs-devs/samples.git |
 |
AI Music Gen | Generate AI music using Google's Lyria model. Combine genres, vibes, and instruments to create custom music tracks with 3D visualizations. | git clone --filter=blob:none --sparse https://github.com/specs-devs/samples.git |
 |
Agent Manager | Multi-agent assistant hub for Specs—run and manage multiple AI agents with text and voice input. | git clone --filter=blob:none --sparse https://github.com/specs-devs/samples.git |
 |
Fetch | Sample project using the Specs Fetch API. | git clone --filter=blob:none --sparse https://github.com/specs-devs/samples.git |
 |
Essentials | Collection of foundational concepts for creating lenses in Lens Studio. | git clone --filter=blob:none --sparse https://github.com/specs-devs/samples.git |
 |
Spatial Image | Convert your 2D images to 3D. | git clone --filter=blob:none --sparse https://github.com/specs-devs/samples.git |
 |
Throw Lab | Sample project demonstrating realistic throwing mechanics in AR. | git clone --filter=blob:none --sparse https://github.com/specs-devs/samples.git |
 |
Voice Playback | Sample project for recording and playing back audio on Specs. | git clone --filter=blob:none --sparse https://github.com/specs-devs/samples.git |
 |
Path Pioneer | Sample project for path creation and path walking experience. | git clone --filter=blob:none --sparse https://github.com/specs-devs/samples.git |
 |
Specs Mobile Kit | SDK for seamless communication between mobile applications and Lenses running on Specs via BLE. | git clone --filter=blob:none --sparse https://github.com/specs-devs/samples.git |
 |
DJ Specs | Interactive DJ turntable experience with realistic vinyl physics and multi-track audio mixing. | git clone --filter=blob:none --sparse https://github.com/specs-devs/samples.git |
 |
Custom Locations | Map real life areas and create AR experiences around those locations. | git clone --filter=blob:none --sparse https://github.com/specs-devs/samples.git |
 |
Navigation Kit | An example project for indoors or outdoors navigation. | git clone --filter=blob:none --sparse https://github.com/specs-devs/samples.git |
 |
Specs Sync Kit | Minimal example of Specs Sync Kit transform synchronization across Connected Lenses. | git clone --filter=blob:none --sparse https://github.com/specs-devs/samples.git |
 |
Snap Cloud World Kindness Day | Demonstrating Snap Cloud integration with real-time database updates and a companion web app. | git clone --filter=blob:none --sparse https://github.com/specs-devs/samples.git |
Reusable components, utilities, and packages for AR development. Clone individual packages using sparse checkout:
| Preview | Title | Description | Clone Command |
|---|---|---|---|
 |
Remote Service Gateway | A package that provides a set of tools that allow to publish lenses with access to user-sensitive data. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Specs Navigation Kit | Set of components designed to simplify the development of navigation experiences for Specs. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
CommerceKit (Closed Beta) | Framework for handling in-app purchases for non-consumable items in Specs. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Specs Interaction Kit Examples | Example scenes and prefabs for SpectaclesInteractionKit and SpectaclesUIKit, including Rocket Workshop and UI starter patterns. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
AI Preview Agent - Inspect | Lens-side bridge that lets an external AI agent observe a running Lens through live scene queries and orthographic render captures. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
AI Preview Agent - Interact | Lets an external AI agent drive a running Lens by synthesizing pinch, poke, and drag hand interactions for end-to-end agent verification. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Supabase Client | Client library for connecting to Supabase backend infrastructure. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Snap Cloud Examples | Collection of examples demonstrating Supabase integration for authentication, real-time data, and cloud storage. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Specs 3D Hand Hints | Suite of animated Hand Gestures Hints. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Interactable Helper | Low to medium fidelity prototyping tool for Specs Interaction Kit components without code. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Function Call Helper | System for exposing function callbacks in the inspector, allowing you to configure and trigger script functions through UI buttons. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Face Mesh | Face mesh tracking setup with customizable materials and transform matching for smooth tracking motion. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Body Mesh | Body mesh tracking and rigging utilities for full-body AR experiences. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Hand Attacher | Attach objects to hand joints in world space with customizable offsets and smooth interpolation. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Reachy Receiver | Integration for Reachy humanoid robot with WebSocket streaming. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Mocopi Receiver | Full-body motion capture integration for Sony mocopi sensors with WebSocket streaming and automatic bone mapping. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
WebSocket Examples | WebSocket examples for real-time data exchange including TextEcho, IMUData, and IMUCube. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Instantiation | Examples for dynamic object creation. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Solvers | Collections of spatial behaviors for Spatial UI or scene objects. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Access Components | Collection of scripts to showcase how to reference and access classes. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
World Query Hit - Spawn On Surface | Performs hit tests for real-world surfaces. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Surface Placement | Detects and recognizes real-world surfaces. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Snap Decorators | TypeScript decorators for simplified event binding and dependency injection to reduce boilerplate code. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Utilities | Comprehensive utility library for scene object management, math operations, animations, and type conversions. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Animation Examples | Native AnimationPlayer tween examples — scale, opacity, push-Z, squish, and timeline-driven animations driven from script. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Runtime Gizmos | Collections of line based tools for debugging or visualization. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Marker Tracking Helper | Provides Marker Tracking Examples. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Volumetric Line | Advanced volumetric line rendering system for 3D graphics. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Specs Shader Library | Collection of seven optimized shaders designed to enhance power efficiency without sacrificing visual quality. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Easy Teleprompter | Teleprompter lens for rehearsal and live public speaking with text display in field of view. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Guided Instructions | Voice-driven, AI-assisted guided AR experiences: speech, depth, Gemini integration, and world-space UI. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Composite Camera Texture | Advanced camera texture compositing and blending system. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |
 |
Crop Camera Texture | Camera texture cropping and region selection tools. | git clone --filter=blob:none --sparse https://github.com/specs-devs/packages.git |