terra-bot

Introduction

The purpose of this System Requirements Document (SRD) is to outline the specifications and requirements for the "terra-bot" project. Terra-bot is an AI-driven solution designed to automate Instagram interactions, specifically focusing on managing comments and direct messages (DMs) for freelancers like Nisha. This bot aims to enhance engagement, streamline communication, and showcase the user's portfolio effectively.

System Overview

Terra-bot is intended to serve as a virtual assistant for Instagram, capable of handling both comments and DMs. The system will leverage AI to provide automated responses, manage interactions, and engage with followers. This will allow freelancers to focus on their core activities while maintaining an active and responsive presence on social media.

Functional Requirements

• As a Freelancer, I should be able to automate responses to common queries in DMs.
• As a Freelancer, I should be able to manage and respond to comments on my posts.
• As a Freelancer, I should be able to showcase my portfolio through automated interactions.
• As a Freelancer, I should be able to customize the bot's responses to align with my personal brand.
• As a Freelancer, I should be able to track engagement metrics to assess the bot's performance.

User Personas

• Freelancer: The primary user of terra-bot, looking to automate Instagram interactions to enhance engagement and manage client inquiries effectively.

Visuals Colors and Theme

• primary: #4A90E2 (a vibrant blue to represent trust and professionalism)
• primary_light: #A6C8F0 (a lighter blue for hover states and secondary UI)
• secondary: #E94E77 (a bold pink for emphasis and links)
• accent: #F5A623 (a bright orange for call-to-action buttons and active states)
• highlight: #F8E71C (a warm yellow for hover states and notifications)
• bg: #F4F4F4 (a light grey for the page background)
• surface: rgba(255, 255, 255, 0.9) (a soft white for card/panel backgrounds)
• text: #333333 (a dark grey for primary text)
• text_muted: #777777 (a medium grey for secondary text and labels)
• border: rgba(200, 200, 200, 0.5) (a subtle grey for borders)

Signature Design Concept

The homepage of terra-bot will feature an interactive galaxy map where each star represents a different feature or section of the bot. Users can click on a star to open a task card, drag to rotate the cluster, and hover to highlight connections between features. This concept will be brought to life using @react-three/fiber and @react-three/drei for 3D interactions, creating an engaging and memorable first impression.

Interaction Model & Motion Direction

The landing page will employ a "parallax" interaction model, providing a layered depth experience via scroll. Decorative layers, such as atmospheric blobs and distant shapes, will translate at different speeds, while real content remains in the normal flow. This approach is ideal for creating a visually rich first impression that tells the story of terra-bot's capabilities.

Non-Functional Requirements

• The system should be able to handle a high volume of interactions without performance degradation.
• The bot must comply with Instagram's API usage policies and guidelines.
• The system should ensure data privacy and security for all user interactions.

Tech Stack

• Frontend: React for Web
• Backend: Python, FastAPI
• Database: MongoDB
• AI Models: GPT 5.4 for user-friendly responses
• AI Tools: Litellm for LLM Routing, Langchain
• Local Orchestration: Docker, docker-compose
• Server-side Orchestration: Kubernetes

Assumptions and Constraints

• The bot will operate within the constraints of Instagram's API limits.
• Users will have an existing Instagram account to integrate with terra-bot.
• The system will be designed to support English language interactions initially.

Glossary

• DM: Direct Message
• AI: Artificial Intelligence
• API: Application Programming Interface
• LLM: Large Language Model

This document outlines the requirements and specifications for the terra-bot project, ensuring a comprehensive understanding of the system's capabilities and design.