For Developers

Setup & Installation

Get JEBAT running on your local machine in 7 steps. Estimated time: 5-10 minutes.

1

Prerequisites

Ensure you have the following installed on your system:

Node.js ≥ 18
node --version
Python ≥ 3.11
python3 --version
Git ≥ 2.40
git --version
Docker (optional)
docker --version
2

Clone the Repository

Get the full JEBAT codebase with all agents, skills, and infrastructure configs.

Clone
git clone https://github.com/nusabyte-my/jebat-core.git
Enter
cd jebat-core
3

Install Dependencies

Install both frontend (Next.js) and backend (FastAPI) dependencies.

Frontend
cd apps/web && npm install && cd ../..
Backend
cd apps/api && pip install -r requirements.txt && cd ../..
4

Configure Environment

Copy the environment template and configure your LLM provider keys.

Copy env
cp infra/docker/.env.example .env
Edit
nano .env  # Add your API keys
5

Start the Backend API

Start FastAPI on port 8000 with memory, agents, and security scanning.

Start API
cd apps/api && python -m services.api.jebat_api &
Verify
curl http://localhost:8000/api/v1/health
6

Start the Frontend

Start Next.js dev server on localhost:3000 with hot reload.

Start frontend
cd apps/web && npm run dev
Open
open http://localhost:3000
7

Install to Your IDE

Inject JEBAT context into your IDE for AI-assisted development.

VS Code
npx github:nusabyte-my/jebat-core install
Verify
cat .github/copilot-instructions.md

✅ Verify Installation

Run these checks to confirm everything is working:

API Health
curl http://localhost:8000/api/v1/health
Expected: {"healthy":true,"database":true,"redis":true}
Frontend
open http://localhost:3000
Expected: JEBAT landing page loads
IDE Context
cat .github/copilot-instructions.md
Expected: JEBAT context file exists