Log inSign up
Kymmsy
KymmsyTLDR
Users paste a URL, and the app returns a 3-sentence summary
Public
Like
1
TLDR
Val Town is a collaborative website to build and scale JavaScript apps.
Deploy APIs, crons, & store data – all from the browser, and deployed in milliseconds.
Sign up now
Code
/
README.md
Search
6/2/2025
Viewing readonly version of main branch: v24
View latest version
README.md

TLDR This - Article & PDF Summarizer

A simple web application that summarizes articles, URLs, and PDF documents into 1-3 sentence summaries using OpenAI's API.

Features

  • Simple Interface: Clean interface for pasting URLs, article text, or uploading PDFs
  • Smart Summarization: Uses OpenAI API to generate concise 1-3 sentence summaries
  • Multiple Input Types:
    • Text: Paste article text directly
    • URL: Automatically fetches and summarizes content from URLs
    • PDF: Upload PDF documents for text extraction and summarization
  • Error Handling: Graceful handling of invalid URLs, PDF parsing errors, API failures, and other errors
  • Responsive Design: Works well on desktop and mobile devices

Project Structure

├── backend/
│   ├── index.ts           # Main Hono server with API routes
│   └── README.md          # Backend documentation
├── frontend/
│   ├── index.html         # Main HTML template
│   ├── index.tsx          # React frontend application
│   ├── components/
│   │   └── App.tsx        # Main app component
│   └── README.md          # Frontend documentation
├── shared/
│   ├── types.ts           # Shared TypeScript types
│   └── README.md          # Shared utilities documentation
└── README.md              # This file

Setup Instructions

  1. Environment Variables: Set up your OpenAI API key in Val Town environment variables:

    • Go to your Val Town settings
    • Add environment variable: OPENAI_API_KEY with your OpenAI API key

  2. Deploy: The app will automatically deploy when you save the files in Val Town

  3. Access: Your app will be available at your Val Town HTTP endpoint

API Endpoints

  • GET / - Serves the main application
  • POST /api/summarize - Summarizes text or URL content
  • GET /frontend/* - Serves frontend assets
  • GET /shared/* - Serves shared utilities

Usage

  1. Open the application in your browser
  2. Paste either:
    • A URL to an article you want summarized
    • The full text of an article
  3. Click "Summarize" button
  4. View the 1-3 sentence summary generated by AI

Error Handling

The app handles various error scenarios:

  • Invalid or unreachable URLs
  • OpenAI API failures or rate limits
  • Network connectivity issues
  • Malformed input data