Lumos项目安装与配置指南
1. 项目基础介绍
Lumos是一个Chrome扩展插件,它通过本地运行的LLM(Language Model,语言模型)提供网页浏览的辅助功能。该项目的目标是实现对网页内容的总结、问题解答等功能,而所有模型的推理过程都在用户的本地机器上进行,不依赖于远程服务器。Lumos使用TypeScript编写,并且作为前端应用程序,它依赖于React框架进行用户界面的构建。
2. 关键技术和框架
- TypeScript:一种由微软开发的开源编程语言,它是JavaScript的一个超集,添加了静态类型选项。
- React:一个用于构建用户界面的JavaScript库,由Facebook维护。
- Chrome扩展API:允许开发者利用Chrome浏览器提供的API来创建扩展插件。
- Ollama:一个用于本地运行的LLM服务器,它为Lumos提供模型推理服务。
3. 安装和配置
准备工作
在开始安装之前,请确保您的开发环境中已安装以下工具:
- Node.js:JavaScript运行环境,用于执行Chrome扩展的本地开发脚本。
- Git:版本控制系统,用于从GitHub克隆项目代码。
- Chrome浏览器:用于加载和测试Chrome扩展。
安装步骤
-
克隆项目
打开命令行工具,执行以下命令来克隆Lumos项目:
git clone https://github.com/andrewnguonly/Lumos.git cd Lumos
-
安装依赖
在项目目录中,使用npm(Node.js的包管理工具)安装项目依赖:
npm install
-
启动Ollama服务
为了让Lumos正常工作,您需要启动一个Ollama服务。根据您的操作系统,执行以下步骤:
-
Windows:
下载并安装Docker,然后打开命令行工具,执行以下命令来启动Ollama容器:
docker run -e OLLAMA_ORIGINS="chrome-extension://*" -d -v ollama:/root/.ollama -p 11434:11434 --name ollama ollama/ollama
-
macOS/Linux:
打开命令行工具,执行以下命令来启动Ollama服务:
# macOS launchctl setenv OLLAMA_ORIGINS "chrome-extension://*" # Linux或macOS ollama serve
确保设置环境变量
OLLAMA_ORIGINS
为chrome-extension://*
。
-
-
加载未打包的扩展
打开Chrome浏览器,进入
chrome://extensions/
,开启开发者模式,然后点击“加载未打包的扩展”,选择Lumos项目的chrome
目录。 -
测试扩展
在Chrome浏览器中,您应该能看到Lumos扩展的图标。点击图标,尝试使用扩展的功能来确认一切正常。
以上步骤应该能够帮助您成功安装和配置Lumos项目。如果在安装过程中遇到任何问题,请查看项目的GitHub页面上的README文件,那里可能有更多的信息和解决方案。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考