Docs·4ff474d·Updated Mar 14, 2026·43 ADRs
User Guides

Using the Service Provider Directory

Karmyq has two layers: the mutual aid layer (karma-based, gift economy) and the service provider layer (paid, professional). This guide covers the service provider directory.

Using the Service Provider Directory

Karmyq has two layers: the mutual aid layer (karma-based, gift economy) and the service provider layer (paid, professional). This guide covers the service provider directory.


Finding a Provider

Go to Service Providers in the main navigation. You'll see two tabs:

  • Individuals — solo providers (tutors, handypersons, drivers)
  • Collectives — organizations of providers (rickshaw stands, cooperatives)

Filter by service type to narrow results. Each card shows a trust score badge, average star rating, and pricing notes.

Trust score badge colors:

  • Green (80–100) — highly reliable, strong track record
  • Blue (60–79) — solid completion rate
  • Yellow (40–59) — newer provider, building reputation
  • Gray (below 40) — limited history

Click a provider card to see their full profile: bio, ride details (if applicable), which collectives they belong to, and all reviews.


Becoming a Provider

  1. Go to Service Providers → Become a Provider
  2. Choose your service type (ride, tradesperson, tutor, or other)
  3. Write a bio and set pricing notes (advisory only — Karmyq never processes payment)
  4. For rides: add your vehicle type and typical routes
  5. Submit — your profile is now visible in the directory

You can edit or deactivate your profile at any time from the provider detail page.


Provider Collectives

A collective is an organization of providers — a rickshaw stand, repair cooperative, or tutoring group. Collectives can:

  • Group multiple provider profiles
  • Serve multiple communities
  • Show a combined trust score across all members

Joining a collective: Find a collective in the Collectives tab, open its detail page, and click Join Collective (you need a provider profile first).

Creating a collective: Go to Service Providers → Collectives → Create Collective. Choose service types, write a description, and add location notes. As admin, you can link your collective to communities and manage members.

Linking to a community: From your collective's detail page, use Link to a Community. This makes the collective appear in that community's admin Providers tab.


Community Settings

Community admins can configure provider integration under Admin → Providers:

  • Enable provider services — toggles whether provider directory is highlighted to community members
  • Minimum trust score — the floor personal trust score for providers visible to this community
  • Collectives serving this community — shows linked collectives, with option to unlink

Reviews and Trust

After interacting with a provider, you can leave a star rating and short review on their profile.

Provider trust scores are calculated from:

  • Stars (60%) — average rating across all reviews
  • Completion rate (30%) — did they finish jobs they started?
  • Response rate (10%) — do they reply to inquiries promptly?

This is separate from the personal trust score used in mutual aid. A great provider does not need to have helped anyone move furniture.


What Karmyq Handles (and Doesn't)

Karmyq is coordination infrastructure, not a marketplace. It handles finding providers and reading reviews. Pricing notes are advisory only — Karmyq never processes payment, handles booking, or arbitrates disputes. The relationship between provider and customer is theirs to manage.