[![HackTJ 10.0 Video Demo](https://d112y698adiu2z.cloudfront.net/photos/production/software_photos/002/408/545/datas/original.png)](https://www.youtube.com/watch?v=ZW48QwsxJvo)

## Inspiration
Humans today face so much turmoil, and they do so at lightspeed with modern technology. Relationships move in the blink of an eye; how can we be so connected and yet so alone simultaneously? The Suicide Prevention Hotline is a resource for anyone who is contemplating self-harm or just needs someone to talk to. With such a vital resource, how is it acceptable that a sixth of all callers hang up because they're stuck listening to hold music while they wait for an operator? [(source)](https://www.wsj.com/story/15-million-calls-to-suicide-hotline-were-abandoned-before-they-were-answered-786860d7)

## What it does
**Vitality** will connect users to an AI language model trained on mental health resources and specifically prompt-engineered to provide concise and inquisitive responses while the caller waits for the next available operator. **Vitality** then provides a chat log and AI-generated summary of its conversation with the caller so that operators can pick up the dialogue exactly where it stopped. The entire workflow is effortlessly seamless, such that the caller always has something or someone to listen.

## How we built it
**Vitality** was built in < 24 hours by Alvan Caleb Arulandu and Rushil Umaretiya at HackTJ 10.0, where it won the distinction of "Best Overall Hack". 

### Phone Webhooks + STT + TTS
Rushil primarily focused on leveraging Twilio's Calling and VoiceResponse API to detect, process, and respond to incoming calls. Particularly, we leveraged webhooks to run custom server-side code in response to a user's real-time conversation. For example, the below snippet records a user's response. 
```javascript
const gather = twiml.gather({
  action: "/call/respond",
  method: "POST",
  input: "speech",
  language: "en-US",
  speechTimeout: "auto",
  model: "experimental_conversations",
});
```
Using TwiML, we can use AWS Polly's voice transcription model to generate an accurate record of what the user asks the service. 

### Context-Aware Language Model
Using Prisma and MongoDB, I was able to maintain an ongoing conversation history which I then fed into OpenAI's latest `gpt-3.4-turbo` model. 
```javascript
model Session {
  id String @id @default(auto()) @map("_id") @db.ObjectId

  startedAt DateTime @default(now())
  transferedAt DateTime?
  endedAt DateTime?

  callId String @unique
  callerPhone String

  summary String?
  
  operatorPhone String?
  operator Operator? @relation(fields: [operatorPhone], references: [phoneNumber])

  messages Message[]
}
```

With some prompt engineering prowess, I was able to contextualize the model, allowing it to refer to reputed mental health resources in it's real-time responses. Further, I used the same model to summarize the conversation to faciliate easy review.
```javascript
export const summarize = async (sessionId) => {
  const context = [
    {
      role: "system",
      content:
        "This is a conversation between you and someone calling the suicide prevention hotline. Please summarize the main issues that the caller is facing and highlight important points in the conversation. Keep your summary short.",
    },
  ];
....
```
Using my library functions, Rushil was able to integrate OpenAI's responses into the real-time phone conversation.

### Operator Call Center Interface
I also expanded our ExpressJS server to power a NextJS frontend for hotline operators to view active calls, summarize chat logs, and transfer calls. This system architecture prevents dropped calls, and data logging provides maximal transparency for both the virtual therapist and client.

## Challenges we ran into
As you can see, the myriad of services that we brought together requires that data need to be extensively processed to make information compatible with Twilio, OpenAI, AWS, and Prisma. We spent the first 5 hours of the hackathon honing in only 200 lines of code, but that hard work was the glue that brought the entire project together. Plowing through page after page of deprecated documentation and confusing APIs taught us a lot about data abstraction and working with audio streams.

## Accomplishments that we're proud of
A working [demo](https://www.youtube.com/watch?v=ZW48QwsxJvo)! In 24 hours, just two of us could bring together a project we were told would be impossible. By the submission deadline, we were able to successfully design the entire workflow from dialing the number to getting real help, and make it look good too! The demo really showed us the viability of the design, and we're excited to see where this thing goes.

## What we learned
In-person hackathons are amazing. We spent much time glued to our chairs typing away at our laptop keyboards, but the environment around us was surreal. It was crazy seeing all these coders actually in-person all in one place for the entire 24 hours (both of our first full hackathons IRL). Whether running around scrounging for snacks at 2 AM or seeing the immense variety in talent and niches, our experience at HackTJ is one for the books.

## What's next for VitalityAI
Sky's the limit. The thing about our design is that the application we put it to is one of millions of ways this tech stack could be used. Tweaking the prompt by just a few sentences could automatically route calls to an insurance company, gather vital information when emergency responders are at capacity, or provide worldwide access to health resources at the dial of a number. At the moment, we're generalizing our application architecture to support multiple call centers, and we are also in the process of patenting our design! There are so many ways to put this project to use, so overall, we're excited to see what the future holds 🎉


[![TJVMT Homepage](./home.png)](https://tjvmt.com)
## Problem
"1+1 trivially equals 2" — when a logical conclusion is deemed "trivial" by a mathematician, it is dismissed as a simple exercise for the reader. But for the average misinformed mathlete, "trivial", paired with a complicated competitive math topic, is a sign of dominance.

\
"This problem is trivial by roots of unity filters!" — in my freshman year, nearly 35 students dropped out of Varsity Math Team (VMT) because of demeaning sentences like these.

## Solution
When I was elected statistician, I was greeted by a complex network of spreadsheets that have underpinned club proceedings since 2003: competition rankings, t-shirt surveys, election polls—that's it, I'm making a website! After a week of development, the management tool was born, but now, VMT's culture has indirectly transformed. [tjvmt.com](https://tjvmt.com) is now an online ecosystem for the TJHSST competitive math community!

## Development
### Architecture
[tjvmt.com](https://tjvmt.com) is hosted on Vercel, with the help of Google Domains and Google Analytics. Powering the site is Next.js, a production, React.js framework with support for server-side rendering. Our frontend application communicates with a REST API powered by Vercel Serverless Edge Functions, housing application logic. These functions use Prisma to easily CRUD data in our MongoDB cluster, deployed in AWS through MongoDB Atlas. Here's a code snippet of a handler for our directory API.
```javascript
const handler = async (req: NextApiRequest, res: NextApiResponse) => {
  const { authorized, profileBody, user } = await authorize(req, res)
  if (!authorized) return res.status(401).send(null)

  if (req.method == 'GET') {
    const where = req.query.competitor === 'true' ? {competitor: true} : {} 
    let users = await db.user.findMany({where})

    const players = (await (await fetch(`https://mee6.xyz/api/plugins/levels/leaderboard/${process.env.DISCORD_GUILD_ID}`, {method: "GET"})).json()).players
    const playerMap = {}; players.forEach(p => playerMap[p.id] = p)

    users.forEach((u) => {
      u['stats'] = u.discordId ? playerMap[u.discordId] : undefined
    })

    users = users.sort((a,b) => b.solvedProblemIds.length - a.solvedProblemIds.length)

    return res.status(200).json({
      users
    })
  }
}
```

### Authentication
Given that [tjvmt.com](https://tjvmt.com) manages student data, security is one of our priorities. The site's login functionality uses OAuth, an industry-standard authentication protocol supported by [ion.tjhsst.edu](https://ion.tjhsst.edu), TJHSST's in-house student intranet. Using ion, our student directory allows mathletes to meet friends and see their profile picture!

### Directory Discord Sync
TJVMT's Discord Server uses MEE6 to motivate members to participate in our diverse community. So, with 3rd party APIs, [tjvmt.com](https://tjvmt.com) stores voluntary Discord identification information to then calculate and display experience points in our directory.

### LaTeX Support
Posting, discussing, and solving problems is a really important part of VMT, so our Problem of The Day (PoTD) system helps members take their problem solving to the next level. [tjvmt.com](https://tjvmt.com) supports LaTeX posts through MathJax, a JavaScript display engine for mathematics.

### Attendance
Replacing our physical attendance system, VMT's teacher sponsors are able to create password-protected polls to track attendance. This also allows the club to record our most active members for future elections!

### Automated Rankings
Decades-old rankings formulas have been migrated into admin-triggered compute jobs running on Vercel Serverless. Our grading portal allows officers to quickly input team selection test scores, which then update a public facing rankings system. To combat imposter syndrome, our rankings protect score anonymity while motivating students to improve over the competition season. Checkout our ranking algorithm below!
```typescript
let subs = tst.submissions.filter(s => !s.writer)
let answers = subs.map(s => s.answers)
let solves = answers.reduce((a, b) => a.map((e, i) => e + b[i])) 

if(tst.weighted){
  let weights = solves.map(s => s == 0 ? 0 : 1+Math.log(answers.length / s)) // weight: 1 + Log(submissions/solves)
  answers = answers.map(s => s.map((x, i) => x*weights[i]))
}

// compute scores: sum(answers)
let scores = answers.map(x => x.reduce((a, b) => a+b))

// compute top 12 average
let top = 12
let topAvg = [...scores].sort((a, b) => b-a).slice(0, top).reduce((a, b) => a+b)/top
let index = scores.map(s => s*2000/topAvg) // index = 2000*score/top12avg

await db.tST.update({where: {id: tst.id}, data: { solves }})

// update submission documents
await Promise.all(subs.map(async (s, i) => {
  await db.submission.update({
    where: {
      id: s.id,
    },
    data: {
      index: index[i],
      score: scores[i]
    }
  })
}))

await Promise.all(tst.submissions.filter(s => s.writer).map(async (s) => 
  await db.submission.update({where: {id: s.id}, data: {index: 2000}})
))
```

## Testimonials
This year, Sophia, a freshman, came to her first VMT meeting knowing almost half of the upperclassmen with the online directory. Calvin, another freshman, published over fifteen problems through the website's Problem of the Day system, and Luv, also a freshman, used the website's Discord-link feature to join and promote summer “group-solve” sessions. Since tjvmt.com's introduction, attendance is not only faster online but freshman VMT signups have rebounded, and on March 14th, VMT will set a record for the most pies eaten without hands! 🥧

## What's Next?
With 241 users weekly users and over 28,000 weekly views, I think it's safe to consider [tjvmt.com](https://tjvmt.com) a success, but my dream is to expand the site to serve more than just VMT. Hopefully, one day, [tjvmt.com](https://tjvmt.com) will be a place for all mathletes, beyond those just competing for TJHSST. 


[![Flight Game](./home.png)](https://claeb101.github.io/flight)
## Summary
A fun game I'm building that still needs some work...
### Real-Time Physics Simulation
Inspired by the technique proposed by this [paper](https://doi.org/10.1109/ICUAS.2015.7152411), I was able to simulate physics in real-time!


Projects