import { Button } from "@/components/ui/button" import { Sparkles, Users, Download, Brain, Shield, Zap, Tv, Heart, Code, Globe, MessageSquare, Layers, Network, Lock, UserCheck, BarChart3, Languages, Trash2, FileText, Headphones, CloudSun, Smartphone, Dices, Cat, Music, Bot } from "lucide-react"; import { SiTypescript, SiPostgresql, SiDocker, SiNextdotjs, SiBun, SiForgejo } from "react-icons/si"; import { RiTelegram2Line } from "react-icons/ri"; import { BsInfoLg } from "react-icons/bs"; import { TbRocket, TbSparkles } from "react-icons/tb"; import Link from "next/link"; import { TbPalette } from "react-icons/tb"; import Footer from "@/components/footer"; export default function About() { return (

About Kowalski

Kowalski is an open-source, feature-rich Telegram bot built with modern web technologies. From AI-powered conversations to video downloads, user management, and community features — it's designed to enhance your Telegram experience while respecting your privacy.

Architecture

We've built Kowalski with modern technologies and best practices for reliability and maintainability.

Tech Stack

Kowalski is built completely in TypeScript with Node.js and Telegraf. The web interface uses Next.js with Tailwind CSS, while data persistence is handled by PostgreSQL with Drizzle ORM.

TypeScript + Node.js
Type-safe backend w/ Telegraf
Next.js WebUI
Modern, responsive admin and user panel
PostgreSQL + Drizzle ORM
Reliable data persistence

Deployment

Kowalski is built to be deployed anywhere, and has been tested on multiple platforms. We prioritize support for Docker and Bun for easy deployment.

Docker Support
Easy containerized deployment w/ Docker Compose
Bun
A fast JavaScript runtime for best performance
{/* some ppl probably don't know what af means :( */}
Modular AF Backend
Command-based structure for easy feature addition

AI Integrations

Powered by Ollama, Kowalski has support for 50+ AI models, with customizable options for users and admins.

Vast Model Support

Kowalski has support for 50+ models, both thinking and non-thinking. We have good Markdown parsing, with customizable options for both users and admins.

/ask - Quick Responses
Fast answers using smaller non-thinking models
/think - Deep Reasoning
Advanced thinking models with togglable reasoning visibility
/ai - Your Custom Model!
Use your personally configured AI model

Kowalski's Powerful

We have amazing Markdown V2 parsing, queue management, and usage statistics tracking. It's hella private, too. AI is disabled by default for the best user experience.

Streaming
Real-time Markdown V2 message updates as the model generates
Usage Stats
Track your AI requests and usage with /aistats
Queues
High usage limits with intelligent request queuing

We're User-First

Kowalski has privacy-focused user management with customizable settings, multilingual support, and transparent data handling.

Privacy

User data is minimized and linked only by Telegram ID. No personal information is shared with third parties, and users maintain full control over their data with easy account deletion options.

Limited Data Collection
Only essential data is stored, linked by Telegram ID
Transparent Policies
Clear privacy policy accessible via /privacy
Easy Account Deletion
You can delete your data at any time

Customization

Personalize your experience with custom AI preferences, temperature settings, language selection, and detailed usage statistics.

AI Preferences
Choose default models and configure temperature
Multilingual Support
English and Portuguese language options
Usage Analytics
Personal statistics and usage tracking

There's WAYYYYY more!

Beyond AI, Kowalski has a ton of entertainment, utility, fun, configuration, and information commands.

Media Downloads

Download videos from YouTube and 1000s of other platforms using yt-dlp. Featuring automatic size checking for Telegram'.

/yt [URL] - Video downloads
Automatic size limit handling

Information & Utilities

Access real-world information like weather reports, device specifications, HTTP status codes, and a Last.fm music integration.

/weather - Weather reports
/device - GSMArena specs
/last - Last.fm integration

Entertainment

Interactive emojis, random animal pictures, My Little Pony, and fun commands to engage you and your community.

/dice, /slot - Interactive games
/cat, /dog - Random animals
/mlp - My Little Pony DB

Our Community

Kowalski is built by developers, for developers. We use open licenses and take input from our development communities.

Open Development

Kowalski is licensed under BSD-3-Clause with components under Unlicense. Our codebase is available on our Forgejo and GitHub, with lots of documentation.

Public Code
Feel free to contribute or review our code
Documentation
We have documentation to help contributors, users, and admins
Contributor Friendly
Our communities are welcoming to new contributors

Community Centric

Kowalski was created by Lucas Gabriel (lucmsilva). It is now also maintained by ihatenodejs, givfnz2, and other contributors. Thank you to all of our contributors!

Active Maintenance
Regular updates and fixes w/ room for input and feedback
Quality Code
We use TypeScript, linting, and modern standards
Focus on New Features
We are always looking for new features to add
Ready to contribute?
); }