Skip to content

Quick Start Guide

Get FenLiu up and running in 5 minutes!

1. Start the Server (1 min)

fenliu --reload

Visit http://localhost:8000 in your browser.

2. Add Your First Stream (1 min)

  1. Click Streams in the navigation
  2. Click Create New Stream
  3. Enter a hashtag (e.g., python)
  4. Select your instance (default: mastodon.social)
  5. Click Create

3. Fetch Posts (1 min)

  1. Click Fetch All to retrieve posts for your stream
  2. Watch the progress modal update
  3. Posts will appear in your database

4. Review Posts (1 min)

  1. Click Review to open the review interface
  2. See posts with AI classification badges
  3. Click Approve ✓ or Reject ✗ on posts

5. Export to Curated Queue (1 min)

  1. Click Queue to view the export queue
  2. See approved posts ready for export
  3. Monitor delivery status
  4. Use Previous/Next buttons to browse images

Key Concepts

AI Classification

  • FenLiu classifies each post's text and first image
  • The review page shows a badge (AI: OK, AI: reject — …, AI: pending)
  • See AI Classification

Post States

  • 🟢 Approved: Ready to export to Curated Queue
  • 🔴 Rejected: Will not be exported
  • ⚪ Pending: Awaiting review decision

Queue States

  • 🟨 Pending: Waiting to be processed
  • 🔵 Reserved: Currently being processed
  • 🟢 Delivered: Successfully exported
  • 🔴 Error: Failed to export

Settings

Click Settings to configure:

  • Attachments-Only Export: Only export posts with media
  • Auto-Reject Blocked Posts: Auto-reject blocked users/hashtags
  • Don't Reblog Users: Block specific accounts
  • Don't Reblog Hashtags: Exclude posts with certain hashtags

Next Steps