neurojs

neurojs 是一个用于在浏览器中进行深度学习的 JavaScript 框架。它主要专注于强化学习，但也可以用于任何基于神经网络的任务。项目包含一些精美的演示，以直观展示这些功能，例如一辆 2D 自动驾驶汽车。

欢迎贡献代码！这类项目的开发在社区中会更加精彩！

注意：由于更通用的框架（如 TensorFlow.js）的出现，本仓库已不再维护，建议您使用这些框架。

特性

• 实现了一个全栈的基于神经网络的机器学习框架
• 扩展的强化学习支持
  • 统一和优先级回放缓冲区
  • 优势学习（增大动作差距）https://arxiv.org/pdf/1512.04860v1.pdf
  • 支持 深度 Q 网络 和 演员-评论家 模型（通过深度确定性策略梯度）
• 网络配置（权重等）的二进制导入导出
• 高性能

示例

• 自动驾驶汽车
• 高级 XOR
• Andrej Karpathy 的 Waterworld（用 NeuroJS 替换了 ConvNetJS）

运行示例

npm install
npm start

在浏览器中打开 http://localhost:8080/examples/，选择您想要运行的演示。

下一步计划

• 更多示例（Pong、摆锤、贪吃蛇、改进版汽车等）
• 对 Web Worker 的支持
• LSTM 和时间反向传播

NeuroJS 快速上手指南

⚠️ 重要提示：本仓库已停止维护。作者建议开发者转向使用更通用的框架，如 TensorFlow.js。本文档仅作为历史参考或特定遗留项目学习之用。

NeuroJS 是一个用于在浏览器中进行深度学习的 JavaScript 框架，主要专注于强化学习（Reinforcement Learning），但也适用于其他基于神经网络的任务。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows、macOS 或 Linux
• 运行时环境：Node.js (推荐 LTS 版本)
• 包管理器：npm (随 Node.js 自动安装)
• 浏览器：现代浏览器（Chrome, Firefox, Edge 等）

安装步骤

1. 克隆项目或下载源码到本地目录。
2. 打开终端，进入项目根目录。
3. 安装依赖包：

npm install

💡 国内加速提示：如果 npm install 速度较慢，建议使用淘宝镜像源进行安装：

npm install --registry=https://registry.npmmirror.com

基本使用

NeuroJS 提供了多个可视化示例来展示其功能（如 2D 自动驾驶汽车）。以下是运行示例的最简步骤：

1. 启动本地服务器： 在项目根目录下执行以下命令：

   npm start
   

2. 访问演示页面： 打开浏览器，访问以下地址：

   http://localhost:8080/examples/
   

3. 选择示例： 在页面中选择您想要运行的演示项目，例如：

   • Self-driving car：2D 自动驾驶汽车模拟
   • Advanced XOR：高级异或逻辑测试
   • Waterworld：基于 Andrej Karpathy 的水世界模拟

核心功能概览

虽然本项目不再更新，但其架构支持以下核心特性，可供学习参考：

• 全栈神经网络框架：直接在浏览器端运行。
• 强化学习支持：包含均匀及优先经验回放缓冲区 (Replay Buffers)、优势学习 (Advantage-learning)。
• 模型支持：支持深度 Q 网络 (DQN) 和 Actor-Critic 模型。
• 高性能二进制导入导出：支持网络配置（权重等）的二进制序列化。