imtomt

imtomt / ymawky

Public

MacOS Web Server written entirely in ARM64 assembly

18
0
100% credibility
Found May 09, 2026 at 18 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Assembly
AI Summary

ymawky is a minimal static file web server handcrafted in low-level code for Apple Silicon Macs, allowing local hosting of websites with basic upload and download support.

How It Works

1
🔍 Discover ymawky

You come across ymawky, a fun and tiny web server handmade for newer Apple Macs to share simple websites locally.

2
🛠️ Install prep tools

Get Apple's free building tools so you can set up the server on your Mac.

3
📁 Organize your site

Make a folder called www, put your web pages like index.html inside, and add fun error pages if you like.

4
🚀 Launch the server

Build and start your web server with easy steps, and it begins listening on your local computer.

5
🌐 See it in action

Open your web browser, visit the local address like 127.0.0.1:8080, and watch your pages load perfectly.

6
📤 Share and upload

Upload new files, serve images or videos, and enjoy features like partial downloads for smooth playback.

🎉 Your site is live!

Celebrate having your own speedy local web server sharing exactly what you want, safely confined to your machine.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 18 to 18 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is ymawky?

ymawky is a barebones MacOS webserver built entirely in ARM64 assembly, serving static files from a configurable document root like a www/ folder on Apple Silicon Macs. It handles GET, PUT, DELETE, OPTIONS, and HEAD requests, with MIME type detection for everything from HTML and JS to videos and archives, plus range requests for smooth video scrubbing. Run it via `./ymawky [port]` on 127.0.0.1 for quick local hosting of MacOS web apps or static sites, complete with custom error pages and basic WebDAV-like uploads up to 1GB.

Why is it gaining traction?

This stands out as a syscall-only, no-libc fork-per-connection server in pure assembly—tiny, fast, and a masterclass in low-level ARM64 hacking for MacOS GitHub runners or local dev setups. Developers dig the built-in defenses like path traversal blocks, symlink rejection, slowloris timeouts, and atomic PUT writes, making it safer than naive scripts without the bloat of Node or Python alternatives. The hook? Proving you can ship a functional MacOS webserver without a single high-level line, perfect for assembly nerds tweaking GitHub Actions on ARM64.

Who should use this?

Assembly enthusiasts or MacOS ARM64 tinkerers building minimal GitHub CLI tools, desktop apps, or SSH-keyed local servers for static assets. Ideal for frontend devs testing MacOS web apps with range-supported media, or ops folks spinning up quick WebDAV servers for file drops in GitHub workflows. Skip if you need public IPs, dynamic content, or cross-platform without tweaks.

Verdict

Fun proof-of-concept with solid docs and features for a 18-star project, but its 1.0% credibility score screams toy—not production-ready due to MacOS-only quirks and zero tests. Grab it for learning or ultra-light MacOS webserver experiments, not real traffic.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.