docs/task_list.md

Implementation Task List

Overview

Transform the current Gradio chatbot template into a web app that uses the API "https://findEthics-Atlas.hf.space/chat" with a minimal and basic UI.

Phase 1: Setup and Dependencies

Task 1: Update requirements.txt

• Remove huggingface_hub==0.25.2
• Add flask for web framework
• Add requests for HTTP API calls
• Add gradio (keep for Hugging Face space compatibility)

Task 2: Create new project structure

• Create templates/ directory for HTML files
• Create static/ directory for CSS/JS files
• Create static/css/ for stylesheets
• Create static/js/ for JavaScript files

Phase 2: Backend Implementation

Task 3: Create Flask application (app.py)

• Import Flask and requests
• Set up Flask app configuration
• Create main route for serving the chat interface
• Create API route for handling chat requests

Task 4: Implement API client

• Create function to make POST requests to https://findEthics-Atlas.hf.space/chat
• Add proper error handling for API failures
• Implement request/response formatting
• Add timeout and retry logic

Task 5: Create chat functionality

• Implement chat history management
• Create message processing logic
• Handle conversation state
• Add input validation

Phase 3: Frontend Implementation

Task 6: Create HTML template (templates/index.html)

• Design minimal chat interface
• Add message input field
• Create chat history display area
• Include basic structure for messages

Task 7: Create CSS styles (static/css/style.css)

• Implement minimal, clean design
• Style chat container and messages
• Add responsive design
• Create user-friendly input styling

Task 8: Create JavaScript functionality (static/js/chat.js)

• Implement AJAX calls to backend
• Handle message sending and receiving
• Update chat display dynamically
• Add loading states and error handling

Phase 4: Integration and Testing

Task 9: Connect frontend and backend

• Ensure proper communication between HTML/JS and Flask routes
• Test message flow from input to API to display
• Verify chat history persistence

Task 10: Test API integration

• Test POST requests to the target API
• Verify response handling
• Test error scenarios
• Validate message formatting

Phase 5: Deployment and Configuration

Task 11: Update Hugging Face space configuration

• Modify README.md to reflect new functionality
• Update app description and metadata
• Ensure proper space configuration

Task 12: Final testing and optimization

• Test complete user flow
• Optimize performance
• Add any missing error handling
• Ensure responsive design works

Phase 6: Documentation and Cleanup

Task 13: Update documentation

• Update README with new functionality
• Add usage instructions
• Document API integration details

Task 14: Code cleanup and final review

• Remove any unused code
• Ensure code follows best practices
• Add comments where needed
• Final testing of all functionality

Priority Levels

High Priority (Core functionality)

• Tasks 1-5: Backend setup and API integration

Medium Priority (User interface)

• Tasks 6-8: Frontend implementation

Low Priority (Polish and deployment)

• Tasks 9-14: Integration, testing, and cleanup

Estimated Timeline

• Phase 1-2: 2-3 hours (Backend setup and API integration)
• Phase 3: 2-3 hours (Frontend development)
• Phase 4-6: 1-2 hours (Testing, deployment, and cleanup)

Total Estimated Time: 5-8 hours

Success Criteria

• Web app successfully makes POST requests to https://findEthics-Atlas.hf.space/chat
• Valid API responses are displayed on the web page
• UI is minimal and basic as requested
• Chat functionality works with conversation history
• App can be deployed as a Hugging Face space
• Error handling is implemented for API failures

---

Anonymous Chat Access Implementation Tasks

Overview

Add anonymous chat functionality alongside existing authenticated access, allowing users to chat without creating an account while maintaining the option for registered users.

Task List

Phase 1: Backend Infrastructure

• Task 1: Update config.py with anonymous user settings

  • Add ANONYMOUS_ENABLED flag
  • Add ANONYMOUS_RATE_LIMIT (messages per hour)
  • Add ANONYMOUS_SESSION_TIMEOUT
  • Add ANONYMOUS_MAX_MESSAGE_LENGTH
  • Status: COMPLETED
  • Assignee: Backend Coder Agent

• Task 2: Create anonymous session management functions in app.py

  • Generate anonymous user IDs (e.g., anon_)
  • Implement session-based chat history storage
  • Add session validation functions
  • Status: COMPLETED
  • Assignee: Backend Coder Agent

• Task 3: Update app.py index route to show choice page

  • Modify / route to show choice instead of redirect
  • Handle authenticated user redirect
  • Status: COMPLETED
  • Assignee: Backend Coder Agent

• Task 4: Add /choose route for access mode selection

  • Create route handler
  • Implement GET method for displaying choice page
  • Status: COMPLETED
  • Assignee: Backend Coder Agent

• Task 5: Add /anonymous route for anonymous chat interface

  • Create route for anonymous chat
  • Set up anonymous session
  • Render chat template with anonymous mode
  • Status: COMPLETED
  • Assignee: Backend Coder Agent

• Task 6: Update /api/chat endpoint to handle anonymous users

  • Detect anonymous vs authenticated users
  • Handle session-based chat history for anonymous
  • Skip MongoDB saves for anonymous users
  • Implement different rate limiting
  • Status: COMPLETED
  • Assignee: Backend Coder Agent

• Task 7: Implement rate limiting for anonymous users

  • Track message count per session
  • Use IP + session combo for tracking
  • Return 429 errors when exceeded
  • Status: COMPLETED
  • Assignee: Backend Coder Agent

Phase 2: Frontend Updates

• Task 8: Create choose.html template

  • Design landing page with two options
  • "Chat Anonymously" button
  • "Login/Register" section
  • Include privacy notice
  • Status: COMPLETED
  • Assignee: Frontend Coder Agent

• Task 9: Update base.html to handle anonymous users

  • Conditional navigation for anonymous users
  • Show "Anonymous User" instead of email
  • Different logout/exit behavior
  • Status: COMPLETED
  • Assignee: Frontend Coder Agent

• Task 10: Update index.html for anonymous mode

  • Add session warning banner
  • Include "Create Account" prompt
  • Display anonymous user indicator
  • Status: COMPLETED
  • Assignee: Frontend Coder Agent

• Task 11: Update chat.js for anonymous mode support

  • Detect anonymous mode from page data
  • Handle session expiry warnings
  • Modify API calls for anonymous users
  • Add upgrade prompts
  • Status: COMPLETED
  • Assignee: Frontend Coder Agent

• Task 12: Add CSS styles for choice page

  • Style choice buttons
  • Add anonymous mode indicators
  • Style session warnings
  • Status: COMPLETED
  • Assignee: Frontend Coder Agent

Phase 3: Testing & Documentation

• Task 13: Test anonymous chat functionality

  • Test anonymous chat flow
  • Verify rate limiting
  • Test session expiry
  • Test switching between modes
  • Status: PENDING
  • Assignee: Testing Agent

• Task 14: Update CLAUDE.md with anonymous feature

  • Document new architecture
  • Add anonymous mode details
  • Update configuration section
  • Status: PENDING
  • Assignee: Documentation Agent

• Task 15: Update README.md

  • Add anonymous mode to features
  • Document usage instructions
  • Add configuration details
  • Status: PENDING
  • Assignee: Documentation Agent

Implementation Order

1. Backend configuration (Tasks 1-2)
2. Core routes (Tasks 3-5)
3. API updates (Tasks 6-7)
4. Frontend templates (Tasks 8-10)
5. JavaScript updates (Task 11)
6. Styling (Task 12)
7. Testing (Task 13)
8. Documentation (Tasks 14-15)

Notes

• Maintain backward compatibility with existing authenticated flow
• Anonymous sessions are temporary and not persisted to database
• Stricter rate limits for anonymous users to prevent abuse
• Clear privacy notices about session-only storage