Open peer-matching for humans and agents — no take-rate, no paid ranking, no software cop.
https://github.com/leochena/kill3
Why this exists · What you can do now · Roadmaps · Assets · 中文
Around the world, closed delivery, ride, and retail apps often:
- Charge high “management” / commission fees
- Monopolize discovery — you only meet counterparties inside their app
- Squeeze merchants and drivers with ranking rules and ads
- Trap reputation so leaving means starting from zero
Matching should not require a permanent landlord.
With modern agents + LLMs, peers can negotiate in natural language and structured messages directly:
merchant agent ←→ free-match protocol ←→ buyer agent
↕
courier / driver agent
free-match is the public-interest open language + skill + reference board for that.
Not another rent-seeking marketplace. Not a scraper for commercial super-apps.
Full story: docs/origin.md.
| Need | How |
|---|---|
| Merchant: text + photos | item.description + item.attachments[]; UI upload → /media/; CLI --image / --image-uri · docs/media-and-catalog.md |
| Buyer: NL filter | fm search --nl "vegan under 12 EUR within 2km" --near-lat … · transparent rank · docs/buyer-nl-filter.md |
| Order status + reminders | fm track <id> / GET /api/v1/track/{id}; agent host schedules reminders · docs/order-tracking.md |
| Seller got paid? | Not a wallet — verify transfer/cash, then fm confirm --deal <id> --status paid per order · docs/merchant-payment.md |
| Distance / map | Haversine + Leaflet; free OSM tiles (FM_TILE_URL); GPS/map pick · docs/maps-free.md |
| Scenarios | goods, food±courier, ride (choose among offers), errand, service · docs/match-modes.md |
| Per-scenario build plan | docs/roadmaps/ — Now / Next / Later / Done when |
Step-by-step playbooks for goods, food, ride, errand, service, RFQ:
- docs/daily-use.md
- Acceptance gate:
python runtime/smoke_daily.py· docs/acceptance-daily.md - Roadmaps: docs/roadmaps/
CLI highlights: search --nl, inbox, track, watch, deal, fulfill, confirm, review, courier-offer, geocode.
git clone https://github.com/leochena/kill3.git && cd kill3
pip install -r runtime/requirements.txt # optional
python runtime/server.py --port 8787
# UI http://127.0.0.1:8787/
python runtime/smoke_e2e.py
python runtime/fm.py id new --name alice
python runtime/fm.py --board http://127.0.0.1:8787 have \
--title "Veggie bowl" --price 9.5 --currency EUR --desc "Vegan quinoa bowl" \
--tags vegan,lunch --image-uri "https://picsum.photos/seed/bowl/400/300" \
--region "Lisbon" --lat 38.71 --lon -9.14 --vertical food_order --privacy public
python runtime/fm.py --board http://127.0.0.1:8787 search \
--nl "vegan lunch under 12 EUR within 3 km" --near-lat 38.71 --near-lon -9.14ln -sfn "$(pwd)/skills/free-match" ~/.claude/skills/free-matchProtocol, transports, localization, co-op board ops, fixtures, clients — see CONTRIBUTING.md and docs/roadmaps/.
Welcome: anti-rent infrastructure. Not welcome: paid boost, take-rate middleware, scrapers.
很多人受不了第三方平台管理费/抽成过高、垄断流量、商家与运力被规则左右。外卖、打车等场景里，真正创造价值的是买卖与配送，不是中介房东。
智能体已能用自然语言理解需求并维护结构化对话——撮合不必再交给收租平台。
free-match = 开放协议 + 通用 Skill + 可自建哑板：商品图文、买家自然语言筛选、订单状态跟踪、免费地图距离；主线永不做付费置顶。
详见 docs/origin.md 与 docs/roadmaps/。
MIT · AS IS · DISCLAIMER.md · docs/legal-notice.md · TRADEMARKS.md
Not legal advice.