Recally ✨

Your AI-Powered Memory Assistant for Digital Content

Never lose track of valuable content again. Recally helps you capture, organize, and rediscover knowledge with AI-powered efficiency.

⚡ Key Features

📚 Content Capture & Types

• 🌐 Web Content

  • ✅ Browser extension for one-click saving
  • ✅ Telegram bot integration for mobile capture
  • ✅ Direct in-app article addition
  • ✅ Automatic markdown conversion
  • ✅ Smart CORS image proxy

• 💬 Social Media

  • ✅ Twitter thread unrolling and saving
  • ⌛ Instagram post archiving
  • ⌛ LinkedIn article saving

• 📱 Rich Media

  • ⌛ YouTube video saving & transcription
  • ⌛ PDF document storage & analysis
  • ⌛ Podcast archiving & transcription
  • ⌛ EPUB book organization

🧠 AI-Powered Knowledge Management

• 🤖 Automated Processing

  • ✅ Smart summarization with key points
  • ✅ Intelligent tag suggestions
  • ✅ Content categorization
  • ⌛ RAG-powered knowledge base
  • ⌛ Interactive document Q&A

• 🔍 Discovery & Search

  • ✅ Lightning-fast full-text search
  • ✅ Smart filtering by tags/domains
  • ⌛ Semantic search across content
  • ⌛ Related content suggestions

🔌 Integration Ecosystem

• 🌍 Browser Extensions

  • ✅
  • ✅
  • ⌛ Safari extension

• 📱 Mobile & Messaging

  • ✅
  • ⌛ Mobile apps (iOS/Android)

• 📝 Note-Taking Apps

  • ⌛ Notion sync
  • ⌛ Obsidian plugin

• 📰 Content Sources

  • ⌛ RSS feed integration
  • ⌛ Newsletter management
  • ⌛ Email forwarding

🚀 Get Started in 60 Seconds

Cloud Version (Recommended)

👉 recally.io

• Instant access with Google/GitHub login
• Free during beta (no credit card required)
• Always up-to-date

Self-Hosted Option

For full control over your data:

git clone https://github.com/recally-io/recally
cd recally
cp env.example .env  # Set OpenAI key & DB credentials
docker compose up -d

Access at http://localhost:1323

Note: Requires Docker and OpenAI API key

🛠 Developer Zone

Prerequisites

• mise - Tool version manager and task runner
• Docker & Docker Compose
• (Optional) ngrok for tunneling

Tech Stack

Backend

Frontend

AI

Quick Start for Contributors

1. Install mise:

   curl https://mise.run | sh
   eval "$(mise activate bash)"  # Add to your ~/.bashrc or ~/.zshrc

2. Clone and setup:

   git clone https://github.com/recally-io/recally
   cd recally
   cp env.example .env  # Configure environment variables
   
   # Install all development tools
   mise install
   
   # First-time setup (DB + migrations + code generation)
   mise run setup

3. Start developing:

   # Terminal 1: Backend (hot reload)
   mise run dev:backend
   
   # Terminal 2: Frontend
   mise run run:ui

4. Check our Good First Issues

Development Commands

Development

mise run dev:backend   # Backend with hot reload
mise run run:ui        # Frontend dev server
mise run dev:docs      # Documentation dev server
mise run run           # Build and run production mode

Code Quality

mise run lint          # Lint Go + UI
mise run test          # Run tests
mise run generate      # Generate code (SQL, Swagger)

Database

mise run db:up                    # Start PostgreSQL
mise run migrate:new name=feature # Create migration
mise run migrate:up               # Apply migrations
mise run migrate:status           # Check status
mise run psql                     # Database console

Building

mise run build         # Build all (UI + Docs + Go)
mise run build:go      # Build backend only
mise run build:ui      # Build frontend only

Docker

mise run docker:up     # Start with docker compose
mise run docker:down   # Stop docker compose
mise run docker:build  # Build images

Utilities

mise tasks             # List all available tasks
mise run doctor        # Check environment
mise run clean         # Clean build artifacts
mise run help          # Show help

Troubleshooting

mise command not found

# Install mise
curl https://mise.run | sh
echo 'eval "$(mise activate bash)"' >> ~/.bashrc  # or ~/.zshrc
source ~/.bashrc

Tool installation fails

mise doctor  # Check for issues
mise install --force <tool>  # Force reinstall

Database connection refused

mise run db:up  # Ensure database is running
docker ps | grep postgres  # Verify container

Port already in use

# Change port in .env
PORT=8081 mise run dev:backend

Permission denied on psql

# Ensure docker compose is running
docker compose ps
mise run db:up

📜 Documentation

Explore our comprehensive guides:

• Documentation
• API Reference

Comparison with Similar Tools

Feature	Recally	Pocket	Instapaper	Shiori	Omnivore	Readwise Reader	Hoarder
🌐 Web Article Saving	✅	✅	✅	✅	✅	✅	✅
🧵 Twitter Thread Support	✅	❌	❌	❌	✅	✅	❌
🤖 AI Summarization	✅	❌	❌	❌	✅	✅	✅
🏷️ Smart Tagging	✅	❌	❌	❌	✅	✅	✅
🖼️ CORS Image Proxy	✅	❌	❌	✅	✅	✅	❌
🛠️ Self-Hosted Option	✅	❌	❌	✅	✅	❌	✅
📱 Mobile Support	✅	✅	✅	❌	✅	✅	✅

License

• Non-commercial: AGPLv3
• Commercial: Contact sales@recally.io for enterprise licensing

---

Made with ♥ by Recally Team
Proudly open-core since 2024