Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🏆 KarmaCraft

AI-powered karma building for indie developers
Track relevant posts on Reddit, Hacker News & Indie Hackers — get contextual, genuinely helpful comments generated by Claude AI, delivered straight to your Telegram.


Features

  • Keyword Monitor — polls Reddit, HN, and Indie Hackers for posts matching your keywords
  • AI Comment Generator — Claude generates platform-aware, helpful comments (not spam)
  • Telegram Bot — delivers post + comment with ✅ Approve / ❌ Skip buttons
  • Dashboard — Next.js dashboard with daily stats and karma tracking

Quick Start

1. Clone & configure

git clone https://github.com/yourname/karmacraft
cd karmacraft/backend
cp .env.example .env
# Fill in your keys (see Configuration section)

2. Run with Docker

docker compose up --build

3. Run locally (development)

Backend:

cd backend
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload

Frontend:

cd frontend
npm install
npm run dev

Configuration (backend/.env)

Variable Description
ANTHROPIC_API_KEY Claude API key from console.anthropic.com
REDDIT_CLIENT_ID Reddit app client ID (reddit.com/prefs/apps)
REDDIT_CLIENT_SECRET Reddit app secret
REDDIT_USER_AGENT e.g. KarmaCraft/1.0 by u/yourname
TELEGRAM_BOT_TOKEN From @BotFather on Telegram
TELEGRAM_CHAT_ID Your Telegram user/chat ID (use @userinfobot)
POLL_INTERVAL_SECONDS How often to poll (default: 300 = 5 min)

Architecture

karmacraft/
├── backend/
│   ├── monitors/          # Reddit, HN, Indie Hackers scrapers
│   ├── generators/        # Claude comment generation
│   ├── bot/               # Telegram bot (inline keyboard)
│   ├── db/                # SQLAlchemy models + async DB
│   ├── api/               # FastAPI REST routes
│   ├── orchestrator.py    # Poll → generate → notify loop
│   └── main.py            # App entrypoint + scheduler
├── frontend/
│   └── src/app/           # Next.js 14 App Router dashboard
└── docker-compose.yml


🏆 KarmaCraft (RU)

AI-ассистент для наращивания кармы на Reddit, Hacker News и Indie Hackers

Отслеживает новые посты по ключевым словам, генерирует полезные комментарии через Claude AI и доставляет их в Telegram с кнопками одобрения.


Возможности

  • Мониторинг ключевых слов — отслеживает Reddit, HN и Indie Hackers
  • Генератор комментариев — Claude создаёт контекстуальные, полезные комментарии с учётом тона платформы
  • Telegram-бот — присылает пост + комментарий с кнопками ✅ Одобрить / ❌ Пропустить
  • Дашборд — Next.js страница со статистикой за день и отслеживанием роста кармы

Быстрый старт

cd backend
cp .env.example .env
# Заполните ключи
docker compose up --build

Конфигурация

Переменная Описание
ANTHROPIC_API_KEY Ключ Claude API (console.anthropic.com)
REDDIT_CLIENT_ID ID Reddit-приложения
REDDIT_CLIENT_SECRET Секрет Reddit-приложения
TELEGRAM_BOT_TOKEN Токен от @BotFather
TELEGRAM_CHAT_ID Ваш Telegram ID (через @userinfobot)

Структура проекта

backend/monitors/    — Мониторы Reddit, HN, Indie Hackers
backend/generators/  — Генерация комментариев через Claude
backend/bot/         — Telegram-бот
backend/api/         — FastAPI эндпоинты
frontend/            — Next.js дашборд

About

AI assistant that helps indie devs build karma on Reddit, HN, and Indie Hackers

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages