Caution

This repository is a work in progress. 🚧

🌈🎇_keLL^eM_e$💗💦

Bunch of packages playing around with small and large language models to see what’s what.

Although the majority of the source code is initially generated, I still can’t fully embrace my inner vibe-coder. Without a project plan, I keep having to convince the agents about the uncertain future of this write-only code from my tiny content-window world.

If you’re looking for user-facing documentation, it’ll be on the website… 🤷 eventually.

Features

• 🐣
• 💻 Simple CLI tool compiled into an installable binary that communicates with an Ollama service on- or offline. Set AI parameters, change personality traits, and let the chatbot talk to you satisfied.
• 📚 Bring your own documents and datasets, the Retrieval-Augmented Generation (RAG) system uses vector embeddings and semantic search to give context-aware responses based on a knowledge base.
• 📱 Push your model to the cloud and chat through the mobile app without touching Evil Corp’s server.
• ?
• 💸 Profit

Prerequisites

Running the Docker deamon is recommended for smooth service execution.

Setup MISE-EN-PLACE in the dev environment to handle tool version management.

Configuration

All required environment variable defaults are in mise.toml, without change any of them the rig should work with empty data.

---

If you want to override any of them, create a .env file with the updated values.

Run as a developer

1. Clone the project
2. pnpm i
3. pnpm build
4. docker compose --profile backend up -d
5. pnpm --filter cli dev

Terminal Commands

Run these commands from the project root:

Command	Description
pnpm i	Install dependencies for all packages
pnpm build	Build all packages
pnpm lint	Code lint all packages
pnpm typecheck	Type calidity check all packages
pnpm test	Run tests (where available)
pnpm --filter api dev	Start the API in development mode
pnpm --filter cli dev	Start the CLI app in development mode

Bonus command:

For the first run it setup the database in a permanent Docker volume.

Dependencies

Logo	Name	Description
	mise-en-place	Developer tools version manager.
	pnpm	Install dependencies and run scripts accross the monorepo.
	Biome	Code linter and formatter.
	Node.js	JS runtime.
	Bun	JS runtime for API and CLI executable builds.
	Changesets
	Hono	Post-Express API Framework.
	Kysely	Type-safe PostgreSQL query build and migration manager.
	date-fns

---

---

---

---

• 💭

---

⠀⠀⠀⠀⠀⠀⠀⡀⠠⠠⠀⠚⠁⠁⠁⠁⠁⠁⠂⠄⢀⢀⠀⠀⠀⠀⠀⠀
⠀⠀⠀⠀⢀⠐⠀⠀⠀⣀⡠⠤⣄⠀⠀⠀⠀⠀⢀⣀⣀⡀⠀⢅⠀⠀⠀⠀
⠀⠀⠀⠠⠀⠀⠀⠀⠋⠀⠀⣀⠀⠉⠀⠀⠀⠈⠁⠀⠀⠈⠙⠀⠑⡄⠀⠀
⠀⠀⠀⠂⠀⠀⠀⠀⢠⠖⠉⠀⠉⢣⠀⠀⠀⠀⡤⠖⠒⠲⣄⠀⠀⠈⠄⠀
⠀⠀⠁⠀⠀⠀⠀⠀⡞⠋⡷⢒⡖⣺⠀⠀⠀⡮⣄⣀⣀⣀⡌⡆⠀⠀⠅⠀
⠀⠈⠀⠀⠀⠀⠀⠀⣇⡄⠀⠉⡰⠃⠀⠀⠀⣇⠀⠈⠓⢊⡜⠁⠀⠀⠨⠀
⠀⠁⠀⠀⠀⠀⠀⠀⠀⠈⠉⠁⠀⠀⠀⠀⠀⠀⠉⠉⠉⠀⠀⠀⠀⠀⠈⡀
⠈⠀⠀⢻⠑⢄⣀⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣀⡤⠖⢻⠀⠀⠀⡒⠀⠀⠅
⠅⠀⠀⠸⡀⠀⠀⠀⠉⠙⠒⠢⠤⠔⠒⠉⠉⠀⠀⢀⡇⠀⠀⢐⠎⠀⠀⠅
⢐⠀⠀⠀⢗⠦⢜⡀⠀⠆⠀⠀⠀⠀⠀⠀⠀⢇⡶⠅⠀⠀⠀⠈⠀⠀⠀⡃
⠐⠀⠀⠀⠈⡆⠀⢐⠉⠇⠉⠉⠉⠉⠉⠉⡭⠃⠀⠀⠀⢀⡞⠈⠀⠀⡈⠀
⠀⠡⠀⠀⠀⠀⠑⢾⣀⣁⡀⠀⣀⡤⠎⠁⠀⠀⠀⠀⠀⠈⠀⠀⠀⡈⠀⠀
⠀⠀⠑⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠀⠀⡐⠀⠀⠀
⠀⠀⠀⠀⠣⣀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⡠⠊⠀⠀⠀⠀
⠀⠀⠀⠀⠀⠀⠈⠉⠂⠒⠤⠠⠄⠄⠤⠄⠤⠤⠠⠔⠈⠀⠀⠀⠀⠀⠀⠀

---

---

(TBC)