{"id":27093630,"url":"https://github.com/toxsam/open-source-avatars","last_synced_at":"2025-04-06T08:39:25.283Z","repository":{"id":281807716,"uuid":"946508962","full_name":"ToxSam/open-source-avatars","owner":"ToxSam","description":"Stack of over 300 OpenSourceAvatars free to use on whatever","archived":false,"fork":false,"pushed_at":"2025-03-20T19:30:56.000Z","size":167,"stargazers_count":10,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-20T20:39:55.503Z","etag":null,"topics":["avatar","avatars","free","open-source","three","vrm"],"latest_commit_sha":null,"homepage":"https://www.opensourceavatars.com/","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ToxSam.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-11T08:53:18.000Z","updated_at":"2025-03-20T19:31:00.000Z","dependencies_parsed_at":"2025-03-11T09:22:49.214Z","dependency_job_id":"7f14199b-4251-4131-a981-4939a3e695c4","html_url":"https://github.com/ToxSam/open-source-avatars","commit_stats":null,"previous_names":["toxsam/open-source-avatars"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ToxSam%2Fopen-source-avatars","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ToxSam%2Fopen-source-avatars/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ToxSam%2Fopen-source-avatars/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ToxSam%2Fopen-source-avatars/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ToxSam","download_url":"https://codeload.github.com/ToxSam/open-source-avatars/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247457728,"owners_count":20941905,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["avatar","avatars","free","open-source","three","vrm"],"created_at":"2025-04-06T08:39:24.770Z","updated_at":"2025-04-06T08:39:25.278Z","avatar_url":"https://github.com/ToxSam.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Open Source Avatars\n\n\u003cdiv align=\"center\"\u003e\n  \u003ch3\u003e\u003ca href=\"https://www.opensourceavatars.com\"\u003e🌐 opensourceavatars.com\u003c/a\u003e\u003c/h3\u003e\n  \u003cp\u003eA community-driven gallery of free 3D avatars for the metaverse\u003c/p\u003e\n\u003c/div\u003e\n\n## 🌟 What is Open Source Avatars?\n\nOpen Source Avatars (OSA) is a growing collection of freely available 3D avatars primarily in VRM format for use in virtual reality, gaming, metaverse applications, and any other 3D environments. Our mission is to create an inclusive library of high-quality avatars that anyone can use without worrying about licensing restrictions.\n\nThis repository serves as the **data backbone** for the [Open Source Avatars website](https://www.opensourceavatars.com), containing all the metadata and information about the avatars, projects, and related resources.\n\n### What is VRM?\n\nVRM is an open file format for 3D humanoid avatars primarily used in VR applications. Key features include:\n\n- **Cross-platform compatibility** across different applications and engines\n- **Standardized rigging** making animations work consistently\n- **Customizable expressions** for facial animations\n- **Material definitions** that work across different rendering systems\n\nVRM files can be viewed and used with libraries like [Three.js](https://threejs.org/) and applications like [VRoid Studio](https://vroid.com/en/studio) or [Pixiv's VRoid Mobile](https://vroid.com/en/mobile).\n\n## 🚀 Why Open Source Avatars?\n\n- **Free and accessible 3D avatars** for everyone\n- **Permissive licensing** that allows for personal and commercial use\n- **Community-driven** development and contributions\n- **Diverse selection** of avatar styles, characters, and designs\n- **Compatible formats** for popular platforms and engines\n\n## 📂 What's in this Repository?\n\nThis repository is structured as a database with JSON files containing all the metadata:\n\n- `/data` - The core data directory\n  - `avatars.json` - Detailed information about each avatar (3D models stored on Arweave)\n  - `projects.json` - Collections of related avatars\n  - `tags.json` - Categories and tags for organizing avatars\n  - `users.json` - Creator and contributor information\n  - `downloads.json` - Usage statistics\n  - `avatar-tags.json` - Tagging relationships\n\n### 🔍 Exploring the Avatars\n\nRather than browsing the JSON files directly, we recommend visiting our gallery at [opensourceavatars.com](https://www.opensourceavatars.com) for an interactive experience with:\n\n- Visual previews and thumbnails\n- 3D model viewers\n- Filtering by tags, style, and format\n- Download options for different platforms\n- Creator information and attribution\n\n\n\n## 🔧 How to Use This Avatars\n\n### For 3D Artists and Avatar Users\n\nVisit [opensourceavatars.com](https://www.opensourceavatars.com) for a user-friendly interface to:\n\n- Browse and search for avatars\n- Preview models in 3D before downloading\n- Download in various formats (VRM, FBX, etc.)\n\n### For Developers\n\n1. **Direct API Access**: Access the data via GitHub's raw content:\n   ```\n   https://raw.githubusercontent.com/ToxSam/open-source-avatars/main/data/avatars.json\n   ```\n\n2. **Clone the Repository**:\n   ```bash\n   git clone https://github.com/ToxSam/open-source-avatars.git\n   ```\n\n3. **Integrate with Your Project**:\n   - Use the well-structured JSON data in your applications\n   - Access the 3D models directly via the Arweave links\n   - Build your own avatar selection interface\n\n\n\n### Technical Requirements\n\nTo work with VRM files in your own projects, you'll typically need:\n\n- **For web applications**: Three.js with [three-vrm](https://github.com/pixiv/three-vrm) plugin\n- **For Unity**: [UniVRM](https://github.com/vrm-c/UniVRM) package\n- **For Unreal Engine**: [VRM4U](https://github.com/ruyo/VRM4U) plugin\n- **For viewing/editing**: VRoid Studio, Blender (with VRM add-on), or other 3D tools\n\n## 📊 Data Structure\n\nEach avatar in our collection includes rich metadata such as:\n\n```json\n{\n  \"id\": \"unique-identifier\",\n  \"name\": \"Avatar Name\",\n  \"description\": \"A detailed description of the avatar\",\n  \"thumbnailUrl\": \"https://assets.opensourceavatars.com/...\",\n  \"modelFileUrl\": \"https://arweave.net/...\",\n  \"format\": \"vrm\",\n  \"polygonCount\": 12500,\n  \"materialCount\": 8,\n  \"metadata\": {\n    \"alternateModels\": {\n      \"voxel_vrm\": \"https://arweave.net/...\",\n      \"fbx\": \"https://arweave.net/...\"\n    },\n    \"license\": \"CC-BY-4.0\",\n    \"creator\": \"Creator Name\",\n    \"attributes\": {\n      \"height\": 1.7,\n      \"style\": \"anime\"\n    }\n  }\n}\n```\n\n\n## 💻 Quick Start Guide\n\n### Web Applications\n\n1. **Install Dependencies**\n```bash\n# Using npm\nnpm install @pixiv/three-vrm three\n\n# Using yarn\nyarn add @pixiv/three-vrm three\n```\n\n2. **Basic Implementation**\n```javascript\nimport * as THREE from 'three';\nimport { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader';\nimport { VRMLoaderPlugin } from '@pixiv/three-vrm';\n\n// Create a basic Three.js scene\nconst scene = new THREE.Scene();\nconst camera = new THREE.PerspectiveCamera(75, window.innerWidth / window.innerHeight, 0.1, 1000);\nconst renderer = new THREE.WebGLRenderer();\nrenderer.setSize(window.innerWidth, window.innerHeight);\ndocument.body.appendChild(renderer.domElement);\n\n// Set up lighting\nconst light = new THREE.DirectionalLight(0xffffff);\nlight.position.set(0, 1, 1).normalize();\nscene.add(light);\n\n// Load an avatar\nconst loader = new GLTFLoader();\nloader.registerPlugin(new VRMLoaderPlugin());\n\n// Fetch avatar data\nfetch('https://raw.githubusercontent.com/ToxSam/open-source-avatars/main/data/avatars.json')\n  .then(response =\u003e response.json())\n  .then(avatars =\u003e {\n    const avatar = avatars[0]; // Get first avatar for example\n    loader.load(\n      avatar.modelFileUrl,\n      (gltf) =\u003e {\n        const vrm = gltf.userData.vrm;\n        scene.add(vrm.scene);\n        \n        // Position camera\n        camera.position.z = 2;\n        \n        // Animation loop\n        function animate() {\n          requestAnimationFrame(animate);\n          renderer.render(scene, camera);\n        }\n        animate();\n      },\n      (progress) =\u003e console.log('Loading:', (progress.loaded / progress.total * 100) + '%'),\n      (error) =\u003e console.error('Error loading VRM:', error)\n    );\n  });\n```\n\n### Unity Integration\n\n1. **Install UniVRM**\n   - Open Package Manager (Window \u003e Package Manager)\n   - Click '+' \u003e Add package from git URL\n   - Enter: `https://github.com/vrm-c/UniVRM.git?path=/Assets/VRMShaders`\n   - Repeat for: `https://github.com/vrm-c/UniVRM.git?path=/Assets/VRM`\n\n2. **Basic Usage**\n```csharp\nusing UnityEngine;\nusing VRM;\n\npublic class VRMLoader : MonoBehaviour\n{\n    async void Start()\n    {\n        // Load avatar from URL\n        var avatarUrl = \"https://arweave.net/your-avatar-url\";\n        using (var webRequest = UnityWebRequest.Get(avatarUrl))\n        {\n            await webRequest.SendWebRequest();\n            \n            if (webRequest.result == UnityWebRequest.Result.Success)\n            {\n                var bytes = webRequest.downloadHandler.data;\n                var context = new VRMImporterContext();\n                \n                // Load VRM model\n                await context.LoadAsync(bytes);\n                var gameObject = context.Root;\n                \n                // Add to scene\n                gameObject.transform.SetParent(transform, false);\n            }\n        }\n    }\n}\n```\n\n### Unreal Engine Setup\n\n1. **Install VRM4U Plugin**\n   - Open Epic Games Launcher\n   - Go to Marketplace and search for \"VRM4U\"\n   - Add to your project\n   - Enable the plugin in Edit \u003e Plugins\n\n2. **Blueprint Usage**\n   - Drag a VRM4U_VrmAssetList component into your scene\n   - Set the VRM URL in the component details\n   - Use the \"Load VRM\" function to load the avatar\n\n## 🔧 Compatibility Matrix\n\n| Platform      | Required Version | Compatible Packages                    |\n|--------------|------------------|---------------------------------------|\n| Three.js     | ≥ 0.132.0       | @pixiv/three-vrm ≥ 1.0.0             |\n| Unity        | ≥ 2020.3        | UniVRM ≥ 0.108.0                     |\n| Unreal Engine| ≥ 4.27          | VRM4U ≥ 1.0.0                        |\n\n## 🔍 Troubleshooting\n\n### Common VRM Issues\n\n1. **Model Loading Issues**\n   - Verify the VRM file version compatibility (VRM 0.x vs 1.0)\n   - Check if the model size is within platform limits\n   - Ensure all textures are properly packaged with the VRM\n   - Confirm the model follows VRM specifications\n\n2. **Avatar Display Issues**\n   - Check if the model's meta information is correctly set\n   - Verify material settings in the VRM metadata\n   - Ensure the avatar's scale is appropriate (typical height: 1.6m ~ 1.8m)\n   - Check if all required bone structures are present\n\n3. **Expression/BlendShape Issues**\n   - Verify BlendShape proxy settings in VRM metadata\n   - Check if expression keys are properly defined\n   - Ensure BlendShape groups are correctly configured\n   - Test expressions in VRM Viewer before integration\n\n\n## 🤝 Contributing\n\nHave a cool VRM avatar you'd like to share with the community? We're excited to see what you've created! This collection aims to make amazing avatars accessible to everyone, and your contribution could help creators and developers worldwide.\n\n### How to Submit\n\nThe easiest way to submit your avatar is through GitHub Discussions:\n\n1. **Open a Discussion**:\n   - Go to the \"Discussions\" tab in this repository\n   - Choose the \"Avatar Submission\" category\n   - Use the title format: `[Avatar Submission] Your Avatar Name`\n   - Include the following information:\n     ```\n     Avatar Name:\n     Description:\n     Preview Links: (screenshots/renders, at least 3 views)\n     VRM File: (hosted on Arweave or similar permanent storage)\n     License: (must be open source)\n     Tested On: (list platforms where you've tested the avatar)\n     ```\n\n### Requirements\n\nTo ensure the best experience for everyone using the avatars:\n\n- **Format**: VRM file (mandatory)\n- **Thumbnail**: PNG recomended\n- **License**: Must be open source (CC-BY, CC0, etc.)\n- **Storage**: Must be hosted on permanent decentralized storage (Arweave or similar)\n- **Bonus Points**:\n  - Family-friendly content\n  - Optimized model (recommended: under 15k triangles)\n  - Professional quality textures\n  - Proper VRM metadata and bone structure\n  - Working expressions/BlendShapes\n\n\nWe review all submissions to ensure they work well across different platforms and maintain high quality standards.\n\n## 📜 License\n\n- **Metadata in this repository**: [Creative Commons CC-BY 4.0](https://creativecommons.org/licenses/by/4.0/)\n- **Individual 3D models**: Each has its own license specified in the metadata, typically CC-BY or CC0\n\n\n## 🌐 Connect with Us\n\n- **Website**: [opensourceavatars.com](https://www.opensourceavatars.com)\n- **GitHub**: [ToxSam/open-source-avatars](https://github.com/ToxSam/open-source-avatars)\n- **Twitter**: [@toxsam](https://twitter.com/toxsam)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003eOpen Source Avatars — Democratizing virtual identity for the metaverse\u003c/p\u003e\n\u003c/div\u003e ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoxsam%2Fopen-source-avatars","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftoxsam%2Fopen-source-avatars","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoxsam%2Fopen-source-avatars/lists"}