FastRep

A powerful CLI and web-based tool for tracking daily work activities and generating professional reports.

Features

• Easy Logging: Quickly log your daily work activities via CLI or Web Dashboard.
• Automatic Reports: Generate weekly, bi-weekly, and monthly reports instantly.
• Dual Interface: Use either the command-line interface or the professional web UI.
• AI Summarization: Intelligent summarization for monthly reports using Cline, OpenAI, Anthropic, or Gemini.
• Customizable Templates: Choose from 7+ visual styles (Classic, Bold, Modern, Professional, etc.) with live preview.
• App Mode: Launches as a standalone application window for a cleaner experience.
• Data Management: All data stored locally in a lightweight SQLite database.
• Theme Support: Toggle between Light, Dark, and System themes.

Screenshots

Installation

pip install fastrep

Or install from source for development:

git clone https://github.com/hissain/fastrep.git
cd fastrep
pip install -e .

Quick Start

Web Interface

Launch the web UI:

fastrep-ui

The web interface will automatically open in your default browser at http://127.0.0.1:5000.

Options:

• --port PORT: Run on a custom port (default: 5000).
• --no-browser: Do not open the browser automatically.
• --verbose / -v: Enable verbose logging for debugging.

Command Line Interface

# Add a work log entry
fastrep log -p "Project Alpha" -d "Implemented user authentication"

# View weekly report
fastrep view --mode weekly

For a full list of commands, run fastrep --help.

AI Configuration

FastRep supports AI-powered summarization for monthly reports. You can configure this in the Settings page of the web UI.

• Providers: Supports OpenAI, Anthropic (Claude), Google Gemini, and Custom OpenAI-compatible endpoints (e.g., Ollama).
• Fallback: If no API key is provided, FastRep can use the cline CLI if installed on your system.
• Customization: You can provide custom instructions to the AI (e.g., "Use active voice") and select from various report templates.

Project Structure

fastrep/
├── fastrep/
│   ├── __init__.py
│   ├── cli.py              # CLI commands
│   ├── database.py         # Database operations
│   ├── llm.py              # AI Provider clients
│   ├── models.py           # Data models
│   ├── report_generator.py # Report generation logic
│   └── ui/
│       ├── app.py          # Flask application
│       ├── templates/      # HTML templates
│       └── static/         # CSS files
├── tests/
├── setup.py
└── README.md

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Md. Sazzad Hissain Khan

• GitHub: @hissain
• Email: hissain.khan@gmail.com

Acknowledgments

• Built with Click for CLI
• Web UI powered by Flask
• Database management with SQLite

Support

If you encounter any issues or have questions:

• Open an issue on GitHub
• Check existing issues for solutions

Star ⭐ this repository if you find it helpful!