🛠️Environment Setup

- Deploy a Fiat Standalone

Pre-requisites

1. Docker Engine / other alternatives.

Windows

Docker Desktop is a one-click-install application for your Mac, Linux, or Windows environment that enables you to build and share containerized applications and microservices.

• Follow the instructions from Docker's official website: https://docs.docker.com/desktop/install/windows-install/

• Launch the docker desktop every time you want to use Fiat.

MacOS

Linux

2. Python

• A virtual environment with Python 3.10 or higher versions.

3. FUSE Extension (Optional for using Distributed File System)

Windows

Windows still need to be supported. But it can be used within the WSL. Please follow the Linux intructions.

MacOS

Linux

Install Fiat Libraries

1. Fiat CLI & Fiat Copilot

You can install these two tools via pip -

pip install -i https://pypi.python.org/simple fiat-cli fiat-copilot

Then create a config file named fiat.json-

{
    "log_level": "INFO",
    "envd": {
        "host": "127.0.0.1",
        "cpu": 1,
        "mem": 2,
        "gpu": 0
    },
    "server": {
        "host": "https://fiat.elapsed29.top/fiat",
        "info": {
            "username": "ken",
            "email": "[email protected]"
        }
    }
}

Done! Now you can try it within your Python REPL -

Fiat Copilot can be use as a utility library and Fiat CLI can be used within your terminal app.

Optional

If you would like to use the dash, metastore, and ray commands, please follow the steps down below to make additional configurations -

• Clone the repo or download the project zip file from here.

• Copy the "docker" folder into the path: $HOME/.fiat/docker

2. Fiat Server

Clone the repo -

git clone https://gitee.com/fialet/fiat-server.git

Then, activate your virtual environment and install Python packages -

# move into app folder
cd fiat-dash

# and `pip`
pip install -r requirements.txt

Next, configure the metastore URL within the config.json config file -

{
    "metastore": "http://localhost:8090"
}

Finally, launch your Fiat Server backend with the command -

# For testing
uvicorn main:app --reload

# For deployment
uvicorn main:app \
--host 0.0.0.0 \ # server listening
--port 8000 \    # server port
--workers 4      # number of workers

You can access the Swagger UI to explore the server endpoints -

• The Swagger UI serves at: http://{host:port}/fiat/documentation

Fiat Server Swagger UI

3. Fiat Dash

Clone the repo -

git clone https://gitee.com/fialet/fiat-dash.git

Then, install dependencies -

# move into app folder
cd fiat-dash

# use npm to install packages
npm install -i .

Finally, launch the dashboard app -

npm run serve

Fiat Dash!