Skip to content

⚡ Quick Start with LifeTrace ⚡

1. Clone Project Repository

First, clone the LifeTrace project from GitHub:

bash
git clone https://github.com/FreeU-group/LifeTrace.git
cd LifeTrace

2. Install Dependencies

First, install uv if you haven't already:

bash
# macOS
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Then, in the project folder, install the dependencies:

bash
# Sync dependencies from pyproject.toml and uv.lock
uv sync
# Activate virtual environment
# macOS
source .venv/bin/activate

# Windows
.venv\Scripts\activate

3. Start Services

Start Backend Service

In the project folder, run the server:

bash
python -m lifetrace.server

Start Frontend Service

In the project folder, run the frontend development server:

bash
cd frontend
pnpm install
pnpm dev

4. Start Using

Once both services are running, open your browser and visit http://localhost:3000 to start using LifeTrace! 🎉