https://github.com/3forges/kairos
Grab the kairos, it is time to take action. TODO: https://github.com/rdev/liquid-glass-react
https://github.com/3forges/kairos
fastapi react whisper-ai
Last synced: about 2 months ago
JSON representation
Grab the kairos, it is time to take action. TODO: https://github.com/rdev/liquid-glass-react
- Host: GitHub
- URL: https://github.com/3forges/kairos
- Owner: 3forges
- License: mit
- Created: 2025-05-25T12:46:24.000Z (about 1 year ago)
- Default Branch: develop
- Last Pushed: 2025-08-12T13:05:57.000Z (11 months ago)
- Last Synced: 2025-08-19T23:18:06.728Z (10 months ago)
- Topics: fastapi, react, whisper-ai
- Language: TypeScript
- Homepage:
- Size: 818 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# Kairos
To deploy Kairos you will need at least one machine with:
* 4 CPUs
* 10 GB of RAM,
* also 100GB hard disk
* a GNU/Linux, a debian 12 is recommended
* Docker, and docker compose installed
Once the deployment of kairos is done, you do not need any connection to the internet for it to work, and you will have:
* A React frontend,
* A FastAPI REST API
* A Postgres Database
* A Whisper AI Speech-to-text service
And in the React frontend, you an press a microphone button, speak, and the private Whisper AI will trasncribe to text what you say.
It WILL work with only 4 CPU, no GPU, and 10 GB of RAM, but the whisper AI will be slow, very slow.
So for a production deployment, you will need more CPU, and especially you will need GPUs. We will provide technical details for that, in future releases.
Never the less, the point of this first release, is to give you a fully private Whisper Speech-to-text Service ACTUALLY working, with a decent react frontend, and a decent REST API.
Enjoy.
## Deploy first
```bash
export DESIRED_RELEASE='0.0.2'
export KAIROS_HOME=~/kairos_home
if [ -d ${KAIROS_HOME} ]; then
rm -fr ${KAIROS_HOME}
fi;
mkdir -p ${KAIROS_HOME}
git clone git@github.com:3forges/kairos.git ${KAIROS_HOME}
cd ${KAIROS_HOME}
git checkout ${DESIRED_RELEASE}
cd ./speaches/
chmod +x ./start.sh
./start.sh
cd ../
# -
# In the ${KAIROS_HOME}/.env be careful to
# set the BACKEND_CORS_ORIGINS en var. to
# which origins you need, at least for
# HTTP localhost:
# -
# BACKEND_CORS_ORIGINS="http://localhost:5173,http://localhost:8001,http://localhost:8002,http://localhost:8000"
# -
#
docker-compose up -d
```
And now on the machine where you deployed, you can use the app at http://localhost:5173/
### Configure more
You can update configs in the `.env` files to customize your configurations.
Before deploying it, make sure you change at least the values for:
- `SECRET_KEY`
- `FIRST_SUPERUSER_PASSWORD`
- `POSTGRES_PASSWORD`
You can (and should) pass these as environment variables from secrets.
Read the [deployment.md](./deployment.md) docs for more details.
## Special Thanks
This first release was created starting from the `0.8.0` release of the awesome