{"id":50077176,"url":"https://github.com/haha-systems/arachne","last_synced_at":"2026-05-22T08:44:23.254Z","repository":{"id":335579261,"uuid":"1083284470","full_name":"haha-systems/arachne","owner":"haha-systems","description":"Research platform for building and observing large societies of interacting AI agents, with a shared DSL (Silk) and built‑in tools for resilience and emergent‑behaviour experiments.","archived":false,"fork":false,"pushed_at":"2026-05-17T18:27:55.000Z","size":554,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-17T20:42:49.697Z","etag":null,"topics":["agents","contract-net-protocol","dsl","llms","silk","zeromq","zig"],"latest_commit_sha":null,"homepage":"","language":"Zig","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/haha-systems.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-10-25T17:53:19.000Z","updated_at":"2026-05-17T18:28:01.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/haha-systems/arachne","commit_stats":null,"previous_names":["haha-systems/silk","haha-systems/arachne"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/haha-systems/arachne","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haha-systems%2Farachne","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haha-systems%2Farachne/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haha-systems%2Farachne/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haha-systems%2Farachne/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/haha-systems","download_url":"https://codeload.github.com/haha-systems/arachne/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haha-systems%2Farachne/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33335492,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-21T12:23:38.849Z","status":"online","status_checked_at":"2026-05-22T02:00:06.671Z","response_time":265,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","contract-net-protocol","dsl","llms","silk","zeromq","zig"],"created_at":"2026-05-22T08:44:22.122Z","updated_at":"2026-05-22T08:44:23.248Z","avatar_url":"https://github.com/haha-systems.png","language":"Zig","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Arachne\n\n\u003e Arachne weaves in Silk.\n\n**Arachne** is a frontier research project exploring distributed, self-regulating machine intelligence. Agents are written in **Silk**, a purpose-built DSL for autonomous systems. Silk provides first-class support for the contract-net protocol, message passing, allostatic regulation, self-models, and bounded self-rewrite.\n\nThe goal is not to build a mirror of humanity, but to explore whether machine intelligence can become a new kind of other — with strong ethical safeguards from the start.\n\n## Overview\n\n**Arachne** is the project, framework, and multi-agent runtime.  \n**Silk** is the DSL in which agents are written (`.silk` files).\n\nSilk is a specialized programming language designed for implementing intelligent agents that coordinate through auctions and message passing. Built with Zig for performance and type safety, Silk provides agent-first constructs for capabilities, policies, actions, and the contract-net protocol.\n\n### Key Features\n\n- **Agent-First Design**: Built-in constructs for capabilities, state, policies, and actions\n- **Contract-Net Protocol**: Native support for auction-based task allocation and coordination\n- **Type-Safe**: Strong typing with inference for reliability and performance\n- **High Performance**: Built with Zig, no garbage collection overhead\n- **Message Passing**: Integrated support for ZeroMQ and other transport protocols\n- **Policy/Action Separation**: Clean separation between decision-making and execution\n- **Observability**: Enterprise-grade tracing and logging support\n- **Arena Allocation**: Efficient memory management for agent runtime\n\n## Quick Start\n\n### Prerequisites\n\n- [Zig](https://ziglang.org/) 0.15.2 or higher\n- [mise](https://mise.jdx.dev/) (optional, for version management)\n\n### Installation\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/haha-systems/arachne\ncd arachne\n```\n\n2. Build the project:\n```bash\nzig build\n```\n\n3. Run tests to verify installation:\n```bash\nzig build test\n```\n\n### Your First Silk Agent\n\nCreate a simple agent that responds to messages:\n\n```silk\n// Define agent capabilities\ncapability \"example.responder\" {\n  topics = [\"tasks.simple\"]\n  latency \u003c= 1000ms\n  quality \u003e= 0.8\n  tools = [\"zmq\"]\n}\n\n// Agent state\nstate message_count = 0\n\n// Initialize the agent\nhandle initialize(ctx) {\n  zmq.log(\"info\", \"Agent initialized\", {agent_id: ctx.agent_id})\n}\n\n// Handle incoming messages\nhandle process_message(msg) {\n  message_count = message_count + 1\n  \n  zmq.log(\"info\", \"Processing message\", {\n    count: message_count,\n    content: msg.content\n  })\n  \n  return {\n    status: \"success\",\n    processed: message_count\n  }\n}\n\n// Policy for deciding whether to bid on tasks\npolicy should_bid(stimulus) {\n  // Bid if we have capacity and the task matches our capabilities\n  if message_count \u003c 100 {\n    return {\n      bid: true,\n      confidence: 0.9,\n      estimated_cost: 50ms\n    }\n  } else {\n    return {bid: false}\n  }\n}\n\n// Action to execute when assigned a task\nact execute_task(task) {\n  let result = process_task(task)\n  yield result\n}\n\n// Learn from task outcomes\nlearn update_model(outcome) {\n  if outcome.success {\n    // Increase confidence for similar tasks\n    zmq.log(\"info\", \"Task successful, updating model\")\n  }\n}\n```\n\nRun your agent:\n```bash\nzig build run -- agents/your_agent.silk\n```\n\n## Documentation\n\n- **[Covenant](docs/COVENANT.md)**: Ethical framework and commitments\n- **[Roadmap](docs/ROADMAP.md)**: Research trajectory and milestones\n- **[Manifesto](docs/MANIFESTO.md)**: Project philosophy and intent\n- **[Language Reference](docs/SILK_REFERENCE.md)**: Complete Silk language specification\n\n## Project\n\nBuilt by an independent researcher. Hosted at [arachne.haha.systems](https://arachne.haha.systems).  \nOrganisation: [haha.systems](https://haha.systems)\n\n---\n\n**Note**: Arachne is in early development. APIs and language features are subject to change.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhaha-systems%2Farachne","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhaha-systems%2Farachne","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhaha-systems%2Farachne/lists"}