https://github.com/geeknees/vital_aspect
AI-powered 360° Feedback & OKR Platform for psychologically safe teams
https://github.com/geeknees/vital_aspect
360-degree ai feedback okr rails ruby
Last synced: 5 months ago
JSON representation
AI-powered 360° Feedback & OKR Platform for psychologically safe teams
- Host: GitHub
- URL: https://github.com/geeknees/vital_aspect
- Owner: geeknees
- License: mit
- Created: 2025-06-01T11:31:16.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-01-01T04:18:49.000Z (6 months ago)
- Last Synced: 2026-01-01T12:43:14.639Z (6 months ago)
- Topics: 360-degree, ai, feedback, okr, rails, ruby
- Language: HTML
- Homepage:
- Size: 398 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Vital Aspect 🌿
AI-powered 360° Feedback & OKR Platform for psychologically safe teams
*(Rails + Hotwire + SQLite + OpenAI)*
[](https://github.com/geeknees/vital_aspect/actions/workflows/ci.yml)
---
## Table of Contents
1. [Why Vital Aspect?](#why-vital-aspect)
2. [Key Features](#key-features)
3. [Tech Stack](#tech-stack)
4. [Quick Start (5 min)](#quick-start-5-min)
5. [Usage Walk-through](#usage-walk-through)
---
## Why Vital Aspect?
> *“What gets talked about, gets improved — when everyone feels safe to talk.”*
* **Psychological Safety First** – Feedback is anonymous by default, AI suggests tone-softening and bias checks.
* **360° Evaluation Meets OKR** – Continuous pulse surveys merge with quarterly Objectives in one view.
* **AI‐Assisted Coaching** – GPT‐powered insights recommend growth actions for individuals & teams.
---
## Key Features
| Area | Feature |
|------|---------|
| **Feedback** | Anonymous 360° surveys, mutual peer reviews, bias-detection, AI tone rewrite |
| **OKR** | Objectives → Key Results → Weekly Check-ins with Turbo Streams |
| **Insight** | AI summary (strengths / growth areas) & TrustGauge score |
| **Safety** | Opt-out questions, emotion detection, aggregated dashboard |
| **Integrations** | Slack / Email /CSV & Google Sheets export |
---
## Tech Stack
* **Ruby 3.4 / Rails 8** – Hotwire (Turbo, Stimulus)
* **SQLite** – Database
* **OpenAI (GPT-4o mini)** – feedback summarization & bias check
* **Qdrant** – vector similarity for past feedback retrieval
* **Tailwind CSS** – UI Kit
---
## Quick Start (5 min)
```bash
# 1. clone + env vars
git clone https://github.com/geeknees/vital_aspect.git && cd vital_aspect
cp .env.example .env # add OPENAI_API_KEY
# 2. setup and run
bin/rails db:setup
bin/dev
# 3. open
open http://localhost:3000
```
## Usage Walk-through
1. Create Cycle – set OKR quarter & invite respondents
2. Collect Feedback – anonymous links, reminders via Slack bot
3. AI Review – click “Generate Insight” → GPT summary & TrustGauge
4. Align & Plan – turn insights into Key Results in one click
5. Weekly Check-in – team updates, AI suggests confidence wording
Detailed docs: /docs/user-guide.md