-
Notifications
You must be signed in to change notification settings - Fork 11
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #10 from OSU-App-Club/sebat2004/add-readme-usage
Add usage description to README
- Loading branch information
Showing
1 changed file
with
38 additions
and
23 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,36 +1,51 @@ | ||
This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app). | ||
## BeavsAI | ||
|
||
## Getting Started | ||
BeavsAI is an application that provides an AI Chatbot that is knowledgeable about OSU's courses. It allows OSU students to interact with an AI agent that can answer course-specific questions. | ||
|
||
First, run the development server: | ||
## Project Prerequisites | ||
|
||
```bash | ||
npm run dev | ||
# or | ||
yarn dev | ||
# or | ||
pnpm dev | ||
# or | ||
bun dev | ||
``` | ||
- Node: You should install the latest version of [Node](https://nodejs.org/en) | ||
- Docker: The download link is [here](https://www.docker.com/), make sure to choose the correct operating system. | ||
|
||
Open [http://localhost:3000](http://localhost:3000) with your browser to see the result. | ||
## Usage | ||
|
||
You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file. | ||
1. Clone the repository: | ||
```bash | ||
git clone https://github.com/OSU-App-Club/beavsai.git | ||
``` | ||
2. Navigate to the project directory: | ||
|
||
This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel. | ||
```bash | ||
cd ./beavsai | ||
``` | ||
|
||
## Learn More | ||
3. Install all the required dependencies to run our Next.js App | ||
```bash | ||
npm install | ||
``` | ||
|
||
To learn more about Next.js, take a look at the following resources: | ||
> [!NOTE] | ||
> You may come across an peer dependency error when running this command, try `npm install --legacy-peer-deps` | ||
|
||
- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API. | ||
- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial. | ||
4. Create an AUTH_SECRET environment variable | ||
|
||
You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome! | ||
```bash | ||
npx auth secret | ||
``` | ||
|
||
## Deploy on Vercel | ||
5. Add this DATABASE_URL variable to .env.local | ||
|
||
The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js. | ||
``` | ||
DATABASE_URL="postgresql://prisma_user:prisma_password@localhost:5432/prisma_db" | ||
``` | ||
|
||
Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details. | ||
6. Open a new terminal window and start up our Postgres database | ||
|
||
```bash | ||
docker compose up | ||
``` | ||
|
||
7. Run the Next.js App | ||
```bash | ||
npm run dev | ||
``` |