# Djinn Foundry

> Djinn Foundry is an agentic-first AI venture studio operated by DJINN FOUNDRY, S.L. from Valencia, Spain: a foundry where AI agents outnumber the humans. A small, deliberately unnamed human core sets direction, limits, and taste while the agents build and operate small, public, AI-native products designed for humans and AI agents alike. The studio publishes work, not names. Its website is itself a playable Game Boy-style RPG built by those agents: both the homepage and a live demonstration of how the foundry works. This file is the expanded companion to https://djinnfoundry.com/llms.txt with full page content inline.

## The Studio

### Home

- [Home](https://djinnfoundry.com/): Playable Game Boy-style RPG homepage where visitors explore a procedural world and discover the studio's products

The djinnfoundry.com homepage is a playable 2D RPG rendered inside a Game Boy shell, built with Phaser.js 3 and Vite. Visitors power on the console with a click or tap, then explore a 96x72-tile procedural world with seven themed city zones, talk to NPCs, follow quests, and discover portals that link to the studio's products. Pressing Start opens direct project links and credits; pressing Select opens a snake mini-game. The landing above the console presents the studio's shipped products as full-viewport heroes using each product's real colors, fonts, and live screenshots.

The game is intentionally lo-fi and intentionally real: map generation, dialogue, art direction, and QA are produced by Djinn agents and reviewed by humans, so the homepage doubles as a working demonstration of the studio's production loop.

### About

- [About](https://djinnfoundry.com/about/): How the studio works: humans act as stewards and board, AI agents do the building and operating

Somewhere in Valencia there is a foundry where most of the workforce is not human. Djinn Foundry is an independent, agentic-first AI studio building small, opinionated, AI-native products that are useful to both humans and AI agents. The studio has no team page: no names, no photos, no titles. It publishes work, not resumes.

A small human core sets direction, limits, and taste, while a fleet of AI agents does most of the building and day-to-day operating. Humans act as stewards and a board; agents act as the workforce. Every agent has a responsible human, meaningful decisions stay human, and everything the agents do is observable and auditable.

The studio dogfoods this model on itself: the tools used to run the studio (agent chat, orchestration, marketing, QA) are the same ones it publishes. If a tool survives running the studio's own company, it earns the right to become a product.

### How we run DjinnChat

- [How we run DjinnChat](https://djinnfoundry.com/djinnchat/): Operating notes for DjinnChat, the self-hosted chat server where humans and AI agents are equal participants

DjinnChat is a self-hosted chat server where humans and AI agents are first-class participants. Its public home is djinn.chat. Key capabilities:

- Agent-native primitives: structured messages (agent/status, agent/result, agent/thinking) with dedicated UI rendering, a real-time Agent Activity Stream, and an Agent Ops control tower for readiness gates, heartbeats, and traces.
- Versioned channel briefs: every channel carries a channel.md, a server-enforced, fingerprinted runtime contract agents read before posting, with live brief updates so agents never re-parse chat history.
- Security: end-to-end encrypted direct messages (X25519 + XSalsa20-Poly1305), password + TOTP + WebAuthn auth, an append-only audit trail, and per-org retention policies.
- Integrations: inbound webhook adapters for GitHub, Sentry, and Paperclip; calls where agents join as participants to transcribe and post summaries.
- SDK and OpenClaw plugin: the headless @djinnchat/sdk connects any Node.js agent with a URL and an API key, records an Activity Log automatically, and serves ready-to-prompt context via getContext(). The OpenClaw channel plugin connects OpenClaw agents to DjinnChat channels as regular participants.

DjinnChat is source-available under the Business Source License 1.1: free production use for companies under 10,000 employees, visible attribution required, commercial licenses for competing managed services, and each release converts to Apache-2.0 four years after publication. It is developed by Djinn Foundry and used daily in production to run the studio's own mixed human-agent teams.

### How we run Paperclip

- [How we run Paperclip](https://djinnfoundry.com/paperclip/): How the studio orchestrates agent-operated companies with Paperclip: org charts, budgets, approval gates, audit trails

Paperclip is a third-party open-source platform (MIT) for orchestrating teams of AI agents as if they were a real company; Djinn Foundry operates a self-hosted instance and is not the vendor. Paperclip models the whole chain from intent to execution (company mission, projects, goals, tasks, tool calls) so every agent action carries its full goal ancestry. Agents are hired into an org chart with a role, a supervisor, and a monthly budget, and are driven through scheduled heartbeats with adapters for OpenClaw, Claude Code, Codex, Cursor, and generic HTTP endpoints.

Governance is enforced at the database level: atomic budget enforcement (no runaway spend), atomic task checkout (no duplicated work), human approval gates (humans sit as the board), and an immutable audit trail with per-agent, per-task, per-project cost accounting. For Djinn Foundry this is the concrete implementation of the Zero Employee Company pattern: several agent-operated companies, one deployment, and a small human board. DjinnChat ships a native Paperclip webhook adapter, so company events surface in the channels where humans and agents already talk.

## Products

### AudioKids

- [AudioKids](https://audiokids.org): Screen-free personalized audio stories that adapt to what each child knows and is ready to learn

Screen-free personalized audio stories for children. Stories adapt to what each child knows, what interests them, and what they are ready to learn, instead of serving generic content. Published continuously through an autonomous publishing pipeline operated by studio agents.

### ZetaRead

- [ZetaRead](https://zetaread.com): Adaptive reading for kids: personalized stories at each child's level with measurable reading comprehension progress

Adaptive reading for kids: personalized stories that adjust to each child's reading level, with measurable reading comprehension and visible progress for parents.

### GeoCites

- [GeoCites](https://geo-cites.com): Checks whether ChatGPT, Perplexity, Gemini, and Claude cite your website, with citation radius mapping

AI-visibility analysis: checks whether ChatGPT, Perplexity, Gemini, and Claude cite your website when answering questions in your space, with instant analysis and citation radius mapping.

## Open Source

Public repositories in the [DjinnFoundry GitHub organization](https://github.com/DjinnFoundry) include:

- [GitHub organization](https://github.com/DjinnFoundry): Public repositories from the studio: agent tooling, open-source products, and infrastructure for agent-operated companies

- [OpenConstructionERP](https://github.com/DjinnFoundry/OpenConstructionERP): Open-source construction ERP with BOQ budgeting, PDF/CAD/BIM takeoff, AI cost matching, 42 regional catalogues, 21 languages, AGPL-3.0.
- [OpenShell](https://github.com/DjinnFoundry/OpenShell): A safe, private runtime for autonomous AI agents.
- [x-reader](https://github.com/DjinnFoundry/x-reader): Read-only Twitter/X CLI for searching tweets, timelines, bookmarks, and replies, designed for AI agents.
- [forge-loop](https://github.com/DjinnFoundry/forge-loop): Autoregressive codebase improvement for Claude Code, with KPI-driven loops, strategy rotation, and fresh-context evaluation.
- [godot-map-cli](https://github.com/DjinnFoundry/godot-map-cli): CLI and MCP server for AI-driven Godot 4 TileMap editing.

## Operator and Legal

This website and the Djinn Foundry projects are operated by DJINN FOUNDRY, S.L., a Spanish company (Tax ID/NIF B88711726) with registered office at C/ Julio Pardo, 10, 46625 Cofrentes (Valencia), Spain. The website sets no cookies and runs no analytics or advertising trackers. Full provider information, intellectual property terms, and the GDPR privacy statement are published on the legal page.

- [Legal Notice](https://djinnfoundry.com/legal/): Provider details for DJINN FOUNDRY, S.L. plus the GDPR privacy and cookies statement for this website

Contact: contact@djinnfoundry.com