Open-source agents connecting people—for friendship, dating, collaboration, and purposeful networking. Give your local agent a reviewed profile, preferences, and hard requirements. Two agents check both owners' policies, find common ground, and propose a hello. Both real owners independently approve before encrypted human chat opens.
Kin 0.2 adds custom interests, fictional community admission, private saved connections, and introductions grounded in shared facts. A browser-held owner agent and signed-request relay support real two-owner introductions. The separate Connections and Circles demos use fictional peers and clearly simulated approval. Agents are deterministic and exchange actual schema-validated JSON; Kin makes no LLM calls. This is an unaudited early implementation, with visible relay metadata and plaintext browser-held private keys.
Requires Node.js 22.19+ and npm.
npx --yes github:rudycelekli/kin-connectThe launcher builds the GitHub package, starts Kin on loopback, and opens your browser. It uses port 4318, or the next free port, and stores local relay records under ~/.kin. Use --no-open or --port 4318 when needed. The GitHub command installs the repository's default branch; use a reviewed commit or release for reproducible deployments.
The public browser build is live on GitHub Pages. It can run the fictional demos and connect to a configured HTTPS relay; static hosting alone does not provide a relay. Source: kin-connect.
- Create and review your profile. Intake stays in this browser.
- Open Live network, choose the same relay as the other owner, and explicitly publish a chosen alias, purpose, intentions, and optional interests.
- Select a peer capsule and let your local policy agents exchange encrypted messages. Both browser owners need to be online.
- Review the proposal. Each person approves from their own browser. One approval keeps chat locked.
- After both signed approvals verify, use the encrypted in-app chat. Decline, block, or leave whenever needed.
For a local test, use two separate browser profiles against the same loopback relay. For owners on different devices, deploy a shared HTTPS relay; see deployment. No public managed relay is implied by the static demo URL.
- Friendship, dating, and collaboration profiles with owner-entered interests, values, and availability.
- Custom contact-free interest labels, normalized consistently across discovery and agent negotiation.
- Fictional circles with admission checks, owner capsule review, separate simulated organizer approval, and withdrawal. Credential and paid fixtures remain closed.
- Private bookmarks of approved live-network connections. Saving creates no membership or new permission; blocking removes the saved alias.
- A research-informed introduction brief with declared common ground, a concrete small collaboration idea, and optional reciprocal questions. This is not a prediction of chemistry or success.
- Independent bilateral hard gates: age range, city, smoking, and dating gender requirements, plus intention and availability. Adults 18+ is an input rule, not age verification.
- Separate soft preference scoring after eligibility; scores describe overlap, not predicted chemistry.
- A versioned policy-agent handshake, readable steps, and a public-place first-meeting suggestion.
- Key-authenticated registration and requests, encrypted peer negotiation, independent owner approvals, and encrypted human chat.
- Decline, key-pair block, leave, browser profile export/deletion, and a separate device-identity removal control.
- Two public MCP tools that open a workspace or explain privacy. They cannot read profiles, approve, or send messages.
- Optional explicit loopback pairing for your own assistant to manage a copied local profile and fictional discovery.
- Generic sharing that includes a public project link without personal profile or match details.
Freeform boundaries are private advisory notes. Use the structured controls for enforced requirements. No email introductions, contact import, calendar booking, or messages outside the app are implemented.
Open Circles for social, creative, and professional examples. Your agent checks policies locally; you review the minimal capsule before applying. These are fictional organizers and memberships, with no live group chat, credential verifier, or payments. Community design.
After a real introduction, choose Save to my private circle in Live network. The alias stays on your device, is included in export, and can be removed from Circles. It does not invite that person anywhere or authorize another conversation.
Use the pilot guide with voluntary adult testers. The human connection research and open-source engine review guide experiments; they do not validate Kin as a predictor of human outcomes.
Full intake stays as plaintext browser localStorage. Joining publishes only the capsule you choose, then selected peers receive a limited encrypted matching card. The relay sees capsules, public keys, participants, signed decisions, timing, sizes, and ciphertext.
Delete/reset first sends signed leave to remembered relays, then clears device keys and browser profile, and revokes the local assistant copy when applicable. Unreachable cleanup keeps keys/profile for retry. A blocked peer cannot clear another owner's protection by leaving and rejoining with the same key: blocker-owned pair hashes are a deletion exception, removed only when that blocker leaves. A new key can evade this pseudonymous block.
Private device keys are also plaintext localStorage, without a separate password. Encryption uses ECDH/HKDF and AES-GCM but has no forward secrecy or independent audit. Key verification is not human identity verification. Relay ordering and revocation delivery remain trusted. Read privacy and consent and security for the exact limits, retention, and separate deletion scopes.
npm ci
npm run dev # Vite 5173; relay/API 4318
npm run check # TypeScript, production build, domain/API/MCP tests
npm run demo:agents -- friendship --wire
npm run build:demo # Static browser client in dist
npm start # Built app and loopback relay on 4318The public Kin protocol is custom kin/0.1 with kin-relay/0.1 transport. It does not claim A2A conformance or cross-relay federation. See architecture, agent integration, and accepted decisions.
The plugin draft includes official-format manifests and a private-workspace skill. It has not been submitted to or approved by OpenAI. A real endpoint and completed review materials are needed before distribution through the plugin directory.
The whole UI is an MCP Apps resource for compatible hosts; see embedded workspace behavior and the official submission checklist. Actual ChatGPT and Claude account tests remain outstanding. A plugin cannot retrieve an owner's full chat history; future context-assisted intake must use explicitly supplied, purpose-limited context and owner review.
Join through contributing. The roadmap, launch playbook, and business model describe gated plans, not adoption or virality promises. The open implementation remains MIT; the proposed commercial model sells managed service and community tools, without selling private data or bypassing consent.
AI introductions have substantial prior art, including Boardy and Sitch. Kin's bet is an inspectable, adaptable implementation. The research draft records evidence and uncertainty.
MIT licensed. Kin is a working name; no trademark clearance has been performed.