create-t3-turbo-ai - GitLite

KO | EN

gitlite — search

#javascript #ai #go #golang #rust #docker #nodejs #windows #awesome #cli #kubernetes #vue #awesome-list #openai

create-t3-turbo-ai

(★ 354)

Build full-stack, type-safe, LLM-powered apps with the T3 Stack, Turborepo, OpenAI, and Langchain

File Explorer

Download Latest Version (.zip)

- - bug_report.yml
  - feature_request.yml
- - ci.yml
- FUNDING.yml
- extensions.json
- launch.json
- settings.json
- - next.config.mjs
  - package.json
  - postcss.config.cjs
  - README.md
  - tailwind.config.cjs
  - tsconfig.json
- - index.ts
  - package.json
  - transformer.ts
  - tsconfig.json
- - index.ts
  - package.json
  - tsconfig.json
- - index.ts
  - package.json
  - tsconfig.json
.env.example
.eslintrc.js
.gitignore
.npmrc
.nvmrc
LICENSE
package.json
pnpm-lock.yaml
pnpm-workspace.yaml
prettier.config.cjs
README.md
renovate.json
tsconfig.json
turbo.json

# Installation Guide

1. Get the code

git clone https://github.com/zckly/create-t3-turbo-ai

Downloads the entire project code from GitHub to your computer.

cd create-t3-turbo-ai

Moves into the project folder you just downloaded.

2. Node.js

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Node.js Node.js must be installed to use npm. The LTS version is recommended.

└─ CI with pnpm cache setup

Type this command into your terminal and run it.

pnpm i

Type this command into your terminal and run it.

pnpm db:push

Type this command into your terminal and run it.

✅ After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# create-t3-turbo-ai

## NOTE: THIS IS VERY MUCH 🚧 WIP 🚧. A lot of the features are yet to come - stay tuned!

## About

The ultimate starter repo for building full-stack, type-safe, LLM-powered web apps. It uses:
- [Turborepo](https://turborepo.com/) for monorepo management
- [tRPC](https://trpc.io/) for API routing
- [Prisma](https://www.prisma.io/) for database access
- [Next.js](https://nextjs.org/) for the web app
- [OpenAI](https://openai.com/) for the AI
- [Langchain](https://hwchase17.github.io/langchainjs/docs/overview) for LLM management

And much more!

## Folder structure

```
.github
  └─ workflows
        └─ CI with pnpm cache setup
.vscode
  └─ Recommended extensions and settings for VSCode users
apps
  └─ next.js
      ├─ Next.js 13
      ├─ React 18
      ├─ Tailwind CSS
      └─ E2E Typesafe API Server & Client
packages
 ├─ api
 |   └─ tRPC v10 router definition
 ├─ auth
     └─ authentication using next-auth. **NOTE: Only for Next.js app, not Expo**
 └─ db
     └─ typesafe db-calls using Prisma
```

## FAQ

## Quick Start

To get it running, follow the steps below:

### Setup dependencies

```diff
# Install dependencies
pnpm i

# In packages/db/prisma update schema.prisma provider to use sqlite
# or use your own database provider
- provider = "postgresql"
+ provider = "sqlite"

# Configure environment variables.
# There is an `.env.example` in the root directory you can use for reference
# Make sure you add the OPENAI_API_KEY environment variable!
cp .env.example .env

# Push the Prisma schema to your database
pnpm db:push
```

## Deployment

### Next.js

#### Prerequisites

_We do not recommend deploying a SQLite database on serverless environments since the data wouldn't be persisted. I provisioned a quick Postgresql database on [Railway](https://railway.app), but you can of course use any other database provider. Make sure the prisma schema is updated to use the correct database._

**Please note that the Next.js application with tRPC must be deployed in order for the Expo app to communicate with the server in a production environment.**

#### Deploy to Vercel

Let's deploy the Next.js application to [Vercel](https://vercel.com/). If you have ever deployed a Turborepo app there, the steps are quite straightforward. You can also read the [official Turborepo guide](https://vercel.com/docs/concepts/monorepos/turborepo) on deploying to Vercel.

1. Create a new project on Vercel, select the `apps/nextjs` folder as the root directory and apply the following build settings:

<img width="927" alt="Vercel deployment settings" src="https://user-images.githubusercontent.com/11340449/201974887-b6403a32-5570-4ce6-b146-c486c0dbd244.png">

> The install command filters out the expo package and saves a few second (and cache size) of dependency installation. The build command makes us build the application using Turbo.

2. Add your `DATABASE_URL` environment variable.

3. Done! Your app should successfully deploy. Assign your domain and use that instead of `localhost` for the `url` in the Expo app so that your Expo app can communicate with your backend when you are not in development.

## TODO

- [ ] Organize prompts in a prompt library (rather than leaving them in the API folder)
- [ ] Add Promptable.js option
- [ ] Add embeddings example
- [ ] Add PromptLayer example
- [ ] Add Vercel Edge Functions to handle streaming
- [ ] Add ChatGPT w/ memory example
- [ ] Add LLM + Agents example
- [ ] Update to NextJS app directory (once stable)

## References

The stack originates from [create-t3-app](https://github.com/t3-oss/create-t3-app) and [create-t3-turbo](https://github.com/t3-oss/create-t3-turbo). The maintainers of these projects deserve all the credit!