Wasmer Edge Examples

This repository contains runnable examples for deploying applications to Wasmer Edge. Each example mirrors the structure used in python-fastapi, with a concise walkthrough of how it works, instructions for running locally, and a short deployment guide.

Getting Started

1. Install the Wasmer CLI and log in with wasmer login.
2. Clone this repository:

   git clone https://github.com/wasmerio/examples.git
   cd examples
   

3. Pick an example, read its README.md, and follow the “Running Locally” steps.
4. When you are ready to publish, use wasmer deploy from that example directory.

Every example is self-contained. Dependencies, entry points, and Wasmer-specific configuration are documented in the example’s own README.

Repository Overview

Examples are grouped by runtime. “Skip” directories hold work-in-progress templates; “fail” directories capture known issues or failing scenarios for regression testing.

Python

• python-http – stdlib http.server JSON responder.
• python-django – Django 5 project using WSGI.
• python-fastapi – minimal FastAPI hello world.
• python-fastapi-pandoc-converter – FastAPI + pypandoc conversion service.
• python-fastapi-pystone – Pystone benchmark exposed via FastAPI.
• python-ffmpeg – Frame extraction with ffmpeg-python.
• python-flask – Flask hello world.
• python-langchain-starter – Streamlit chat UI backed by LangChain.
• python-mcp – FastMCP server exposing basic tools/resources.
• python-mcp-chatgpt – Cupcake search MCP server for ChatGPT.
• python-mkdocs – MkDocs static documentation site.
• python-pillow – Image transforms with Pillow.

JavaScript & TypeScript

• js-astro-staticsite – Astro static export.
• js-docusaurus-staticsite – Docusaurus docs site.
• js-gatsby-staticsite – Gatsby static site.
• js-next-staticsite – Next.js output: "export" sample.
• js-svelte – Vite-powered Svelte app.
• skip-js-hono-wintercg – Hono app targeting WinterCG workers.
• skip-js-worker-wintercg – Plain WinterCG-compatible worker template.
• fail-js-nuxt-staticsite – Nuxt static export (tracking open issues).
• fail-js-remix-staticsite – Remix static export (tracking open issues).

PHP

• php-basic – Minimal PHP script starter.
• php-laravel – Laravel application.
• php-reactphp – ReactPHP HTTP server.
• php-symfony – Symfony Demo application.
• fail-php-amphp – AMPHP event-loop demo (known limitations).
• fail-php-madeline – MadelineProto client sample (requires Telegram credentials).

Go & Rust

• go-hugo-staticsite – Hugo-generated static site.
• skip-rust-axum – Axum server compiled to WASIX.

Static Sites & Misc

• staticsite – Shared static assets and helper scripts.
• Shipit – Build and deployment recipes used by Wasmer’s internal tooling.

Working With the Examples

• Local development – Most projects rely on the platform tooling for their language (e.g., uvicorn, npm run dev, composer install). Follow the steps in each example README to run locally.
• Deploying – wasmer deploy reads the wasmer.toml (or Shipit configuration) in the example directory to bundle code, configure routes, and upload to your Edge namespace.
• Environment variables and secrets – Use wasmer secret add or set values in your deployment pipeline. Examples that require API keys (e.g., python-langchain-starter) note them explicitly.

Contributing

Contributions are welcome! If you have an example that showcases a new framework or highlights a best practice:

1. Follow the template established in existing READMEs (overview → demo → how it works → local run → Wasmer deployment).
2. Add your directory under the appropriate language prefix (python-, js-, php-, etc.).
3. Update this root README with a short description and link.
4. Open a pull request describing the scenario and any prerequisites.

Additional Resources

• Wasmer Edge documentation
• Wasmer CLI reference
• Support & community forums

Happy deploying!