Skip to content

Commit

Permalink
docs: add quick start
Browse files Browse the repository at this point in the history
  • Loading branch information
amir-kedis committed May 19, 2024
1 parent a289082 commit 6b956d3
Showing 1 changed file with 72 additions and 12 deletions.
84 changes: 72 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,12 +7,22 @@
🐈 Mister Meow 🐈
</h1>

## 📹 Demo
## 📹 Video Demo

https://github.com/amir-kedis/Mister-Meow/assets/88613195/fb2a0634-326d-41d2-bda4-1d5d5c815f54

---

## 📈 Performance

> [!IMPORTANT]
>
> 1. 🕷 Crawler: **1000** pages in **1m12s** with 64 threads
> 2. 📓 Indexer: **1000** pages in **47s** with 50 threads
> 3. 🔎 Search: search is not stable enough but in general it could be improved in the ranker.
---

## ✨ Features

- **MeowCrawler**: crawl the web and insert the data into the database.
Expand Down Expand Up @@ -57,17 +67,7 @@ https://github.com/amir-kedis/Mister-Meow/assets/88613195/fb2a0634-326d-41d2-bda

---

## 📈 Performance

> [!IMPORTANT]
>
> 1. 🕷 Crawler: **1000** pages in **1m12s** with 64 threads
> 2. 📓 Indexer: **1000** pages in **47s** with 50 threads
> 3. 🔎 Search: search is not stable enough but in general it could be improved in the ranker.
---

## System Design
## 🤔 System Design

### Basic System component

Expand All @@ -81,6 +81,66 @@ https://github.com/amir-kedis/Mister-Meow/assets/88613195/fb2a0634-326d-41d2-bda

![Build Index](./docs/imgs/build-the-index-algo.excalidraw.png)

---

## 🚀 Quick Start

### Prerequisites

- Java 11
- Gradle
- MongoDB
- Node

> [!NOTE]
> to install java and gradle see the [Java setup](/docs/conventions/java-env.md) document
> to install mongo see the [mongo setup](/docs/conventions/mongo.md) document
### Installation

1. Clone the repository

```bash
git clone <repo-url>
```

2. Install the dependencies

```bash
cd Mister-Meow
cd mistermeow
gradle build
```

3. To run the crawler

```bash
sudo systemctl start mongod # have to be done once
gradle crawl
```

4. To run the indexer

```bash
gradle index
```

5. To run the server

```bash
gradle engine
```

6. To install and run the web application

```bash
cd app/src/meowapp
npm install
npm run dev
```

---

## Contributions

Please check the following documents before contributing:
Expand Down

0 comments on commit 6b956d3

Please sign in to comment.