Manus Agents

Manus Agents is a powerful AI agent system that combines a modern Next.js frontend with a FastAPI backend to create an interactive AI assistant experience.

Features

• 🤖 AI Agent System - Powered by advanced language models
• 🌐 Real-time Communication - WebSocket-based interaction between frontend and backend
• 🎨 Modern UI - Built with Next.js and Tailwind CSS
• 🔒 Secure - Environment variable based configuration
• 🚀 Scalable Architecture - Separate frontend and backend services

Prerequisites

• Node.js 18+ for frontend
• Python 3.12+ for backend
• Docker (optional, for containerized deployment)

Project Structure

manus-agents/
├── frontend/          # Next.js frontend application
│   ├── src/          # Source code
│   ├── public/       # Static assets
│   └── package.json  # Frontend dependencies
└── backend/          # Python FastAPI backend
    ├── openmanus/    # Core agent functionality
    ├── config/       # Configuration files
    ├── tests/        # Test suite
    └── requirements.txt # Backend dependencies

Getting Started

Backend Setup

1. Create and activate a Python virtual environment:

cd backend
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

2. Install dependencies:

pip install -r requirements.txt

3. Create a .env file in the backend directory with required environment variables:

OPENAI_API_KEY=your_openai_api_key
# Add other required environment variables

4. Start the backend server:

python run_mcp_server.py

Frontend Setup

1. Install dependencies:

cd frontend
npm install

2. Create a .env file in the frontend directory:

NEXT_PUBLIC_API_URL=http://localhost:8000

3. Start the development server:

npm run dev

The application will be available at http://localhost:3000.

Docker Deployment

A Dockerfile is provided for containerized deployment. To build and run:

docker build -t manus-agents .
docker run -p 8000:8000 -p 3000:3000 manus-agents

Development

• Frontend development: npm run dev in the frontend directory
• Backend development: python run_mcp_server.py in the backend directory
• Run tests: pytest in the backend directory

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

License

[Add your license information here]

Support

[Add support information or contact details here]