Skip to content

Shiyinq/quest-by-system

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

QUEBYS - QUEST BY SYSTEM

Sometimes we get confused about what to do today. For example, I'm a software engineer who often gets confused about how to fill my free time. As a result, my days are filled with sleeping or playing games. Therefore, this casual project was created. You will be given quests by an open-source LLM powered by Ollama, so you have references on what to do, for instance, as a software engineer. In short, just like in an MMORPG game, you will be given quests by the system.

quebys

Table of Contents

Requirements

  • Python v3.9.12 ~
  • MongoDB v5.0
  • Ollama latest version

Installation

Make sure you have Ollama installed and at least one model downloaded from Ollama. For a better experience, use the model llama3:instruct.

After that, you can follow the next steps.

Steps to install this project:

  1. Clone this repository

    git clone https://github.com/Shiyinq/quest-by-system.git
  2. Navigate to the project directory:

    cd quest-by-system
  3. Create python environment

    You can use any Python environment like conda or others, but I am using venv. create environment

     python -m venv .venv

    activate environment

     source .venv/bin/activate
  4. Install dependencies:

    pip install -r requirements/base.txt
  5. Create .env file

     cp .env.example .env
  6. Make sure you have created a MongoDB database. The default DB_NAME is quest, but you can change it in the .env file.

Usage

Running the project

sh scripts/start-dev.sh  

Open API Docs

http://localhost:5000/docs

Contributing

  • You can open issues to report bugs or request features.
  • You can fix bugs and add features on your own.
    1. Fork this repository
    2. Create a feature branch git checkout -b new-feature
    3. Commit your changes git commit -m 'Add new feature'
    4. Push to the branch git push origin new-feature
    5. Create a Pull Request

Install Client

You can use the API to create your own client, but we already have clients available for you to try: a Telegram Bot and a Web client.

Documentation for the Telegram Bot and Web client is provided.