AICA Logo

AICA (AI Communication Assistant) is an intelligent email composition platform designed to help users write clearer, context-aware, and tone-appropriate emails quickly and efficiently. Leverage AI-powered assistance to craft professional communications tailored to your audience and purpose.

For detailed guides, technical info, and step-by-step instructions, visit our wiki:

• Home – Overview, app idea, and motivation
• Core Features – All features available on AICA
• Installation & Setup – How to run the project locally
• Tech Stack – Frontend, backend, and libraries
• Project Structure – Directory structure and file organization
• API Documentation – Comprehensive API reference with examples and error handling
• Our Team - Meet the developers behind AICA

Before starting, ensure you have:

• Node.js v18 or higher
• MongoDB (local) or MongoDB Atlas (cloud)
• OpenAI API Key
• Auth0 Account
• Microsoft Azure Account (optional, for Outlook integration)

git clone https://github.com/Etown-CS170/2025-AICA.git
cd 2025-AICA

npm run install:all

This installs all dependencies for root, backend, and frontend.

Copy the example environment file and configure it:

cd backend
cp .env.example .env

Then edit backend/.env with your credentials:

# Server Configuration
PORT=3000
NODE_ENV=development
CORS_ORIGIN=http://localhost:4200
# Auth0 Configuration
AUTH0_DOMAIN=your-auth0-domain.auth0.com
AUTH0_AUDIENCE=https://aica-backend-api
# OpenAI Configuration
OPENAI_API_KEY=sk-your-openai-api-key-here
# MongoDB Configuration
MONGODB_URI=mongodb://localhost:27017/aica
# Or for MongoDB Atlas:
# MONGODB_URI=mongodb+srv://<username>:<password>@cluster0.xxxxx.mongodb.net/aica
# Microsoft Outlook Configuration (Optional)
MICROSOFT_CLIENT_ID=your-microsoft-client-id
MICROSOFT_CLIENT_SECRET=your-microsoft-client-secret
MICROSOFT_REDIRECT_URI=http://localhost:4200/outlook/callback

Get your credentials:

• OpenAI API Key: OpenAI Dashboard
• Auth0 Domain & Audience: Auth0 Dashboard
• MongoDB URI: Local installation or MongoDB Atlas
• Microsoft Client ID & Secret: Azure Portal (optional)

Update frontend/src/environments/environment.ts:

export const environment = {
 production: false,
 apiUrl: 'http://localhost:3000/api',
 auth0: {
 domain: 'your-auth0-domain.auth0.com',
 clientId: 'your-auth0-client-id',
 authorizationParams: {
 redirect_uri: window.location.origin,
 audience: 'https://aica-backend-api'
 },
 cacheLocation: 'localstorage' as const,
 useRefreshTokens: true
 },
 microsoft: {
 clientId: 'your-microsoft-client-id',
 redirectUri: 'http://localhost:4200/outlook/callback',
 tenantId: 'common'
 }
};

Replace placeholders:

• your-auth0-domain → Your Auth0 domain
• your-auth0-client-id → Your Auth0 client ID
• your-microsoft-client-id → Your Microsoft client ID (optional)

⚠️ CRITICAL: Never commit .env files or API keys to version control!

1. Create a Single Page Application in Auth0
2. Set Allowed Callback URLs: http://localhost:4200
3. Set Allowed Logout URLs: http://localhost:4200
4. Set Allowed Web Origins: http://localhost:4200
5. Create an API with identifier: https://aica-backend-api

1. Go to Azure Portal
2. Navigate to App registrations → New registration
3. Set Redirect URI: http://localhost:4200/outlook/callback
4. Under API permissions, add:
   • Mail.Send
   • Mail.Read
   • User.Read
   • offline_access
5. Under Certificates & secrets, create a New client secret
6. Copy the Application (client) ID and Client secret value

Local MongoDB:

# macOS/Linux
sudo systemctl start mongod
# Or start via MongoDB Compass

MongoDB Atlas:

• Ensure your cluster is running
• Verify IP whitelist includes your current IP

npm run dev

This starts both servers concurrently:

• Backend: http://localhost:3000
• Frontend: http://localhost:4200

Expected output:

✅ MongoDB connected successfully
🚀 AICA Backend Server running on port 3000
📧 Environment: development

cd backend
npm install
npm run dev

cd frontend
npm install
npm start

1. Open browser to http://localhost:4200
2. You should see the AICA login page
3. Click Sign In to test Auth0 authentication
4. After login, test email generation:
   • Select a tone (Professional, Friendly, etc.)
   • Select an audience (Professor, Student, etc.)
   • Enter a prompt or use a template
   • Click Send to generate an email
5. (Optional) Test Outlook integration:
   • Click the Settings icon (⚙️)
   • Navigate to Outlook Integration section
   • Click Connect Outlook
   • Authorize AICA to access your Outlook account
   • Generate an email and click Send via Outlook