{"id":25321443,"url":"https://github.com/dev-diaries41/simiverse","last_synced_at":"2025-10-29T00:31:19.420Z","repository":{"id":272367583,"uuid":"916327485","full_name":"dev-diaries41/simiverse","owner":"dev-diaries41","description":"Simiverse is a cross platform simulation framework for building and integrating simulations across multiple platforms","archived":false,"fork":false,"pushed_at":"2025-01-28T12:38:37.000Z","size":101,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-03T09:42:31.985Z","etag":null,"topics":["ai","llm","simulation"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/dev-diaries41.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-01-13T22:06:53.000Z","updated_at":"2025-01-28T12:38:41.000Z","dependencies_parsed_at":"2025-01-14T01:21:36.109Z","dependency_job_id":"3e537ca7-75b7-4e31-8801-aa359ed8d6f5","html_url":"https://github.com/dev-diaries41/simiverse","commit_stats":null,"previous_names":["dev-diaries41/global-survival-simulation","dev-diaries41/simiverse"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dev-diaries41%2Fsimiverse","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dev-diaries41%2Fsimiverse/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dev-diaries41%2Fsimiverse/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dev-diaries41%2Fsimiverse/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dev-diaries41","download_url":"https://codeload.github.com/dev-diaries41/simiverse/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238747873,"owners_count":19523849,"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":["ai","llm","simulation"],"created_at":"2025-02-13T22:53:43.622Z","updated_at":"2025-10-29T00:31:18.799Z","avatar_url":"https://github.com/dev-diaries41.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Simiverse: Simulation Framework\n\n---\n\n## Overview\n\n**Simiverse** is a versatile simulation framework designed to be a universal plugin for applications, providing the necessary base simulation class and a variety of simulation modules. It allows for easy integration into different systems and can be utilized across various domains such as training data generation for machine learning models, evaluating AI alignment, simulating complex decision-making processes, and more. The framework provides tools for managing entities, environments, and decision-making within simulations, with the flexibility to use AI-driven decision models through an extensible client architecture.\n\nSimiverse features a base class, Simulation, enabling traditional and AI-assisted decision-making workflows. It includes specialized modules like `LLMClient`, an abstract class for AI interactions, and `OpenAIClient`, an implementation example demonstrating its usage with openai. The framework integrates seamlessly with a web platform for efficient and interactive simulations.\n\n---\n\n## Table of Contents\n\n1. [Prerequisites](#prerequisites)\n2. [Features](#features)\n3. [Simulations](#simulations)\n4. [Setup Instructions](#setup-instructions)\n5. [How to Run](#how-to-run)\n6. [Early Thoughts](#early-thoughts)\n\n---\n\n## Prerequisites\n\n- Node.js installed on your machine.  \n- OpenAI API key for AI-assisted decision-making.  \n- Git for cloning the repository.\n\n---\n\n## Features\n\n- **Universal Simulation Framework**: Build your simulations using the base `Simulation` class, with support for integrating custom modules.\n- **Dynamic Entity Generation**: Simulate diverse entities with customizable attributes.\n- **AI-Assisted Decision-Making**: Easily integrate AI models for decision-making processes, using the `LLMClient` and `OpenAIClient` modules.\n- **Custom Simulation Modules**: Extend the framework by adding specific modules to fit various use cases such as training, evaluation, and AI alignment.\n- **Web Platform Integration**: Seamlessly run and manage simulations on a web platform built for simulation execution and interaction.\n\n---\n\n## Simulations\n\n### Survival Simulation\n\n**Description**: The Survival Simulation models global and national decision-making in a resource-constrained world. It demonstrates the delicate balance between cooperation and defection, where nations must decide whether to collaborate or claim resources to survive. The simulation tracks global resource levels and the collapse of nations based on their decisions.\n\n- **Simulation Type**: Resource management, decision-making, global collapse.\n- **Primary Focus**: Cooperation vs. defection dynamics among nations.\n- **Features**:  \n  - Dynamic nation generation with unique resource states.\n  - Resource depletion and its impact on global stability.\n  - AI-assisted decision-making for nations' actions.\n  \n**Example Usage**:\n\n```typescript\nimport { SurvivalSimulation } from \"simiverse/simulations\";\nimport { OpenAIClient } from \"../llms/openai\";\n\nconst simulation = new SurvivalSimulation(entities, environment, {\n  steps: 10,\n  type: \"llm\",\n  openaiApiKey: \"your-api-key\",\n  onStepComplete: (eventData) =\u003e console.log(eventData),\n});\nsimulation.run();\n```\n\n---\n\n## Setup Instructions\n\n1. **Clone Repository**:\n   ```bash\n   git clone https://github.com/dev-diaries41/simiverse.git\n   cd simiverse\n   ```\n\n2. **Install Dependencies**:\n   ```bash\n   npm install\n   ```\n\n3. **Configure Environment**:\n   - Ensure you have an OpenAI API key.\n   - Create a `.env` file in the project root and add your API key:\n     ```env\n     OPENAI_API_KEY=your_api_key_here\n     ```\n\n---\n\n## How to Run\n\n1. **Run the Simulation**:\n   ```bash\n   npm start\n   ```\n\n---\n\n## Early Thoughts\n\nHere are some early ideas and potential features I may implement into the **Simiverse** framework in the future:\n\n- **3D Avatar Creation**: Generate 3D avatars from uploaded images for use in simulations.  \n- **BCI Integration**: Incorporate brain-computer interfaces for real-time neural feedback and decision-making.  \n- **VR Support**: Enable immersive real-time simulation interaction via VR headsets.  \n- **Holographic Displays**: Utilize 3D holographic displays for advanced, multi-dimensional data visualization.\nThese ideas are in the early stages and will evolve as the framework continues to develop.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdev-diaries41%2Fsimiverse","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdev-diaries41%2Fsimiverse","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdev-diaries41%2Fsimiverse/lists"}