{"id":46783669,"url":"https://github.com/hyperfy-xyz/hyperfy","last_synced_at":"2026-03-24T03:01:02.742Z","repository":{"id":271629683,"uuid":"906930450","full_name":"hyperfy-xyz/hyperfy","owner":"hyperfy-xyz","description":"World building for everyone","archived":false,"fork":false,"pushed_at":"2026-02-05T23:31:53.000Z","size":15772,"stargazers_count":281,"open_issues_count":24,"forks_count":95,"subscribers_count":17,"default_branch":"main","last_synced_at":"2026-02-06T08:50:17.743Z","etag":null,"topics":["ai","collaborative","game-engine","metaverse","multiplayer","realtime","web2","web3","world-building"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hyperfy-xyz.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"docs/supported-files/hyp-format.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-12-22T10:43:17.000Z","updated_at":"2026-01-31T13:19:41.000Z","dependencies_parsed_at":"2025-01-23T05:21:56.383Z","dependency_job_id":"47e44fab-153f-4fa2-bb48-09638b9608c5","html_url":"https://github.com/hyperfy-xyz/hyperfy","commit_stats":null,"previous_names":["hyperfy-xyz/hyperfy"],"tags_count":17,"template":false,"template_full_name":null,"purl":"pkg:github/hyperfy-xyz/hyperfy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperfy-xyz%2Fhyperfy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperfy-xyz%2Fhyperfy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperfy-xyz%2Fhyperfy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperfy-xyz%2Fhyperfy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hyperfy-xyz","download_url":"https://codeload.github.com/hyperfy-xyz/hyperfy/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperfy-xyz%2Fhyperfy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30874238,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-24T02:58:37.973Z","status":"ssl_error","status_checked_at":"2026-03-24T02:57:23.829Z","response_time":106,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["ai","collaborative","game-engine","metaverse","multiplayer","realtime","web2","web3","world-building"],"created_at":"2026-03-10T01:00:41.166Z","updated_at":"2026-03-24T03:01:02.731Z","avatar_url":"https://github.com/hyperfy-xyz.png","language":"JavaScript","funding_links":[],"categories":["Web3XR"],"sub_categories":["Engines"],"readme":"# Hyperfy ⚡️\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"overview.png\" alt=\"Hyperfy Ecosystem\" width=\"100%\" /\u003e\n  \u003cp\u003e\n    \u003cstrong\u003eBuild, deploy, and experience interactive 3D virtual worlds\u003c/strong\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n## What is Hyperfy?\n\nHyperfy is an open-source framework for building interactive 3D virtual worlds. It combines a powerful physics engine, networked real-time collaboration, and a component-based application system to create immersive experiences that can be self-hosted or connected to the wider Hyperfy ecosystem.\n\n## 🧬 Key Features\n\n- **Standalone persistent worlds** - Host on your own domain\n- **Realtime content creation** - Build directly in-world\n- **Interactive app system** - Create dynamic applications with JavaScript\n- **Portable avatars** - Connect via Hyperfy for consistent identity\n- **Physics-based interactions** - Built on PhysX for realistic simulation\n- **WebXR support** - Experience worlds in VR\n- **Extensible architecture** - Highly customizable for various use cases\n\n[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/hyperfy-xyz/hyperfy)\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- Node.js 22.11.0+ (via [nvm](https://github.com/nvm-sh/nvm) or direct install)\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/hyperfy-xyz/hyperfy.git my-world\ncd my-world\n\n# Copy example environment settings\ncp .env.example .env\n\n# Install dependencies\nnpm install\n\n# Start the development server\nnpm run dev\n```\n\n### Docker Deployment\n\nFor containerized deployment, check [DOCKER.md](DOCKER.md) for detailed instructions.\n\n## 🧩 Use Cases\n\n- **Virtual Events \u0026 Conferences** - Host live gatherings with spatial audio\n- **Interactive Showrooms** - Create product displays and demos\n- **Social Spaces** - Build community hubs for collaboration\n- **Gaming Environments** - Design immersive game worlds\n- **Educational Experiences** - Develop interactive learning spaces\n- **Creative Showcases** - Display 3D art and interactive installations\n\n## 📚 Documentation \u0026 Resources\n\n- **[Community Documentation](https://docs.hyperfy.xyz)** - Comprehensive guides and reference\n- **[Website](https://hyperfy.io/)** - Official Hyperfy website\n- **[Sandbox](https://play.hyperfy.xyz/)** - Try Hyperfy in your browser\n- **[Twitter/X](https://x.com/hyperfy_io)** - Latest updates and announcements\n\n## 📏 Project Structure\n\n```\ndocs/              - Documentation and references\nsrc/\n  client/          - Client-side code and components\n  core/            - Core systems (physics, networking, entities)\n  server/          - Server implementation\nCHANGELOG.md       - Version history and changes\n```\n\n## 🛠️ Development\n\n### Key Commands\n\n```bash\n# Development mode\nnpm run dev\n\n# Production build\nnpm run build\nnpm start\n\n# Clean orphaned assets (experimental)\nnpm run world:clean\n\n# Viewer only (development)\nnpm run viewer:dev\n\n# Client only (development)\nnpm run client:dev\n\n# Linting\nnpm run lint\nnpm run lint:fix\n```\n\n## 🖊️ Contributing\n\nContributions are welcome! Please check out our [contributing guidelines](CONTRIBUTING.md) and [code of conduct](CODE_OF_CONDUCT.md) before getting started.\n\n1. Fork the repository\n2. Create your feature branch: `git checkout -b feature/amazing-feature`\n3. Commit your changes: `git commit -m 'Add amazing feature'`\n4. Push to the branch: `git push origin feature/amazing-feature`\n5. Open a pull request\n\n## 🌱 Project Status\n\nThis project is still in alpha as we transition all of our [reference platform](https://github.com/hyperfy-xyz/hyperfy-ref) code into fully self hostable worlds.\nMost features are already here in this repo but still need to be connected up to work with self hosting in mind.\nNote that APIs are highly likely to change during this time.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyperfy-xyz%2Fhyperfy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhyperfy-xyz%2Fhyperfy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyperfy-xyz%2Fhyperfy/lists"}