Skip to main content

​
Prerequisites

Before installing Tambo360, ensure you have the following installed on your system:

Node.js

Version 18.x or higher required

PostgreSQL

Version 15 or higher recommended

Package Manager

npm or pnpm supported

Git

For cloning the repository
Tambo360 is a monorepo containing both backend (Node.js/Express) and frontend (React/Vite) applications.

​
System Requirements

  • Operating System: Linux, macOS, or Windows with WSL2
  • Memory: Minimum 4GB RAM (8GB recommended)
  • Storage: At least 2GB free disk space
  • Ports: 3000 (backend), 5173 (frontend), 5432 (PostgreSQL)

​
Clone the Repository

First, clone the Tambo360 repository: 
git clone https://github.com/your-org/tambo360.git
cd tambo360

​
Backend Installation

The backend is built with Node.js, Express, Prisma, and TypeScript.
1

Navigate to backend directory

cd apps/backend
2

Install dependencies

npm install
This will install all required packages including:
  • Express 4.22.1 (Web framework)
  • Prisma 5.22.0 (Database ORM)
  • bcrypt 6.0.0 (Password hashing)
  • jsonwebtoken 9.0.3 (JWT authentication)
  • nodemailer 7.0.13 (Email service)
  • Zod 4.3.6 (Schema validation)
3

Generate Prisma client

npx prisma generate
This generates the Prisma Client based on your database schema.
4

Build TypeScript

npm run build
This step is optional for development but required for production deployment.

​
Backend Dependencies

​
Production Dependencies

PackageVersionPurpose
express^4.22.1Web application framework
@prisma/client^5.22.0Database client
bcrypt^6.0.0Password hashing
jsonwebtoken^9.0.3JWT token generation
cors^2.8.5CORS middleware
nodemailer^7.0.13Email sending
zod^4.3.6Schema validation
dayjs^1.11.19Date manipulation

​
Development Dependencies

PackageVersionPurpose
typescript^5.9.3TypeScript compiler
ts-node-dev^2.0.0Development server
prisma^5.22.0Prisma CLI
dotenv^17.3.1Environment variables

​
Frontend Installation

The frontend is built with React 19, TypeScript, Vite, and Tailwind CSS.
1

Navigate to frontend directory

cd apps/frontend
2

Install dependencies

npm install
This will install all required packages including:
  • React 19.2.4 (UI library)
  • React Router Dom 7.13.0 (Routing)
  • TanStack React Query 5.90.21 (Data fetching)
  • Tailwind CSS 4.1.18 (Styling)
  • Axios 1.13.5 (HTTP client)
  • Zustand 5.0.11 (State management)
3

Build for production (optional)

npm run build
The build output will be in the dist/ directory.

​
Frontend Dependencies

​
Production Dependencies

PackageVersionPurpose
react^19.2.4UI library
react-dom^19.2.4React DOM renderer
react-router-dom^7.13.0Client-side routing
@tanstack/react-query^5.90.21Data fetching & caching
axios^1.13.5HTTP client
tailwindcss^4.1.18Utility-first CSS
zustand^5.0.11State management
react-hook-form^7.71.1Form handling
zod^4.3.6Schema validation
lucide-react^0.574.0Icon library

​
Verify Installation

After installation, verify that everything is set up correctly:
1

Check Node.js version

node --version
# Should output v18.x.x or higher
2

Check npm/pnpm version

npm --version
3

Verify backend installation

cd apps/backend
npm list --depth=0
4

Verify frontend installation

cd apps/frontend
npm list --depth=0

​
Troubleshooting

Try using sudo or fix npm permissions:
sudo chown -R $USER /usr/local/lib/node_modules
Alternatively, use a Node version manager like nvm or fnm.
Ensure PostgreSQL is installed and the DATABASE_URL environment variable is set:
export DATABASE_URL="postgresql://postgres:password@localhost:5432/tambo"
npx prisma generate
Delete node_modules and reinstall:
rm -rf node_modules package-lock.json
npm install
Install pnpm globally:
npm install -g pnpm
Make sure to complete the Database Setup and configure Environment Variables before running the application.

​
Next Steps

Docker Setup

Run Tambo360 with Docker containers

Database Setup

Configure PostgreSQL and run migrations

Environment Variables

Set up required configuration

Deployment

Deploy to production

Build docs developers (and LLMs) love

Get started for freeTalk to us