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-angular-staticsite – Angular-style static build.
• js-assemble-staticsite – Assemble-generated static site.
• js-astro-ssr – Astro server output using the Node adapter.
• js-astro-staticsite – Astro static export.
• js-brunch-staticsite – Brunch-style static build.
• js-create-react-app-staticsite – Create React App-style static build.
• js-docusaurus-staticsite – Docusaurus docs site.
• js-eleventy-staticsite – Eleventy-generated static site.
• js-elysia – Elysia HTTP server.
• js-ember-staticsite – Ember-style static build.
• js-express – Express HTTP server.
• js-fastify – Fastify HTTP server.
• js-gatsby-staticsite – Gatsby static site.
• js-gatsby-staticsite2 – Gatsby default starter static site.
• js-h3 – H3 HTTP server.
• js-harp-staticsite – Harp-generated static site.
• js-hexo-staticsite – Hexo-generated static site.
• js-hono – Hono app served by the Node.js adapter.
• js-htmlwithjs-staticsite – Plain static HTML/CSS/JavaScript site.
• js-hydrogen – Hydrogen-oriented Node.js runtime example.
• js-ionic-angular-staticsite – Ionic Angular-style static build.
• js-ionic-react-staticsite – Ionic React-style static build.
• js-koa – Koa HTTP server.
• js-mastra – Mastra-oriented Node.js runtime example.
• js-mcp – HTTP Model Context Protocol server.
• js-metalsmith-staticsite – Metalsmith-generated static site.
• js-nestjs – NestJS-oriented Node.js runtime example.
• js-next-ssr – Next.js server-rendered app.
• js-next-staticsite – Next.js output: "export" sample.
• js-nitro – Nitro-oriented Node.js runtime example.
• js-node – Minimal Node.js HTTP server.
• js-npm-file-subdir – npm subdirectory app using a local file: dependency.
• js-nuxt-staticsite – Nuxt-generated static site.
• js-parcel-staticsite – Parcel-style static build.
• js-pnpm-workspace-subdir – pnpm workspace app in a subdirectory.
• js-polymer-staticsite – Polymer-style static build.
• js-preact-staticsite – Preact-style static build.
• js-react-router – React Router-oriented Node.js runtime example.
• js-remix-ssr – Remix-oriented server runtime example.
• js-remix-staticsite – Remix static export.
• js-sanity-staticsite – Sanity-style static build.
• js-solidstart – SolidStart-oriented Node.js runtime example.
• js-stencil-staticsite – Stencil-style static build.
• js-storybook-staticsite – Storybook static build.
• js-svelte – Vite-powered Svelte app.
• js-sveltekit-staticsite – Compact SvelteKit-style static build.
• js-tanstack-start – TanStack Start-oriented Node.js runtime example.
• js-umijs-staticsite – UmiJS-style static build.
• js-vite-react-staticsite – Vite React static build.
• js-vite-staticsite – Vite-powered static site.
• js-vitepress-staticsite – VitePress documentation site.
• js-vue-staticsite – Vue static build.
• js-vuepress-staticsite – VuePress documentation site.
• js-xmcp – XMCP-oriented Node.js runtime example.
• 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).

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.

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 bundles the selected example, configures routes, and uploads it 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!