Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add usage description to README #10

Merged
merged 1 commit into from
Oct 31, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
61 changes: 38 additions & 23 deletions README.md
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
```
Loading