mirror of
https://github.com/intergalacticalvariable/reader.git
synced 2024-11-15 19:22:20 +08:00
Update README.md
This commit is contained in:
parent
3ecb275e35
commit
5e947f4cfd
24
README.md
24
README.md
|
@ -1,13 +1,15 @@
|
|||
# 📚 Reader: Local Deployment Edition
|
||||
|
||||
🌟 **Live Demo:**
|
||||
|
||||
Example: [https://reader.berlin.cx/https://github.com/intergalacticalvariable/reader/edit/main/README.md](https://reader.berlin.cx/https://github.com/intergalacticalvariable/reader/)
|
||||
|
||||
This is an adapted version of [Jina AI's Reader](https://github.com/jina-ai/reader) for local deployment using Docker.
|
||||
|
||||
## 🎯 What it does
|
||||
|
||||
It converts any URL to an LLM-friendly input with `http://127.0.0.1:3000/https://google.com`. Get improved output for your agent and RAG systems at no cost. This tool helps you prepare web content for Large Language Models, making it easier to process and analyze online information.
|
||||
|
||||
## 🚀 Key Features
|
||||
|
||||
- 🏠 Runs locally using Docker
|
||||
- 🔑 No API keys required - works out of the box!
|
||||
- 🖼️ Saves screenshots locally instead of uploading to Google Cloud Storage
|
||||
|
@ -15,61 +17,49 @@ It converts any URL to an LLM-friendly input with `http://127.0.0.1:3000/https:/
|
|||
- 🌐 Converts web content to LLM-friendly formats
|
||||
|
||||
## ⚠️ Limitations
|
||||
|
||||
- 📄 Currently does not support parsing PDFs
|
||||
|
||||
## 🐳 Docker Deployment
|
||||
|
||||
### Option 1: Using the pre-built image
|
||||
|
||||
1. Pull the latest image:
|
||||
```bash
|
||||
docker pull ghcr.io/intergalacticalvariable/reader:latest
|
||||
```
|
||||
|
||||
2. Run the container:
|
||||
```bash
|
||||
docker run -d -p 3000:3000 -v /path/to/local-storage:/app/local-storage --name reader-container ghcr.io/intergalacticalvariable/reader:latest
|
||||
```
|
||||
|
||||
Replace `/path/to/local-storage` with the directory where you want to store screenshots.
|
||||
|
||||
This command does the following:
|
||||
- Maps port 3000 of the container to port 3000 on your host
|
||||
- Mounts a volume for local storage
|
||||
- Names the container `reader-container`
|
||||
|
||||
3. To stop the container:
|
||||
```bash
|
||||
docker stop reader-container
|
||||
```
|
||||
|
||||
4. To start the container again:
|
||||
```bash
|
||||
docker start reader-container
|
||||
```
|
||||
|
||||
|
||||
### Option 2: Building the image locally
|
||||
|
||||
1. Clone the repository:
|
||||
```bash
|
||||
git clone https://github.com/intergalacticalvariable/reader.git
|
||||
cd reader
|
||||
```
|
||||
|
||||
2. Build the Docker image:
|
||||
```bash
|
||||
docker build -t reader .
|
||||
```
|
||||
|
||||
3. Run the container:
|
||||
```bash
|
||||
docker run -p 3000:3000 -v /path/to/local-storage:/app/local-storage reader
|
||||
```
|
||||
|
||||
## 🖥️ Usage
|
||||
|
||||
Once the Docker container is running, you can use curl to make requests. Here are examples for different response types:
|
||||
|
||||
1. 📝 Markdown (bypasses readability processing):
|
||||
|
@ -91,20 +81,16 @@ Once the Docker container is running, you can use curl to make requests. Here ar
|
|||
```bash
|
||||
curl -H "X-Respond-With: screenshot" 'http://127.0.0.1:3000/https://google.com'
|
||||
```
|
||||
|
||||
5. 📸 Full-Page Screenshot (returns the URL of the webpage's screenshot):
|
||||
```bash
|
||||
curl -H "X-Respond-With: pageshot" 'http://127.0.0.1:3000/https://google.com'
|
||||
```
|
||||
|
||||
## 🙏 Acknowledgements
|
||||
|
||||
This project is based on the excellent work done by multiple contributors:
|
||||
|
||||
1. The original [Jina AI Reader project](https://github.com/jina-ai/reader), which provided the foundation for this tool.
|
||||
|
||||
2. [Harsh Gupta's adaptation](https://github.com/hargup/reader), which served as the immediate basis for this local deployment version.
|
||||
|
||||
|
||||
## 📜 License
|
||||
|
||||
This project is licensed under Apache-2.0 same as the original Jina AI Reader project.
|
||||
|
|
Loading…
Reference in New Issue
Block a user