Your AI-powered Autonomous DevOps, Infrastructure Monitoring & Deployment Engine

Open source platform to Secure, Build, Fix and Deploy any project with AI. Helps in managing huge servers, docker containers, vps, kubernetes clusters, vm's and much more.

🔒 . 🏗️ . 🛠️ . 🚀

PutmeIn combines Ray (an interactive Next.js web console and management dashboard) with Brain (a high-performance Go AI background daemon and Docker orchestrator) into a unified, daemonized system manager.

Key Features

Autonomous DevOps Engine (Brain)

• Security: Scans your code for vulnerabilities and suggests fixes. Also helps you fix the vulnerabilities in your code and in your projects
• Conversational AI Interface: Chat with your infrastructure using natural language.
• Automated Deployment: Deploy projects (Next.js, Nest.js, static sites, and more) with a single message.
• CI/CD Pipelines: Automatic build, test, and deployment workflows.
• Resource Management: Full container lifecycle management (start, stop, restart, view logs).
• Error Resolution: AI-powered debugging and self-healing capabilities.

Full-Stack Dashboard (Ray)

• Modern UI: Beautiful, responsive interface for managing your infrastructure.
• Live Monitoring: Real-time metrics for CPU, RAM, disk usage, and network traffic.
• Container Orchestration: One-click actions for all your Docker containers.
• Security Center: Built-in security scanning and vulnerability detection.
• Multi-Project Support: Manage multiple projects and deployments from a single dashboard.

Quick Start

Option 1: Automatic One-Line Installation (Recommended)

# Linux / macOS / WSL
curl -fsSL https://get.putme.in | bash

# Windows (PowerShell)
irm https://get.putme.in/ps1 | iex

Option 2: Global NPM Installation

npm install -g putmein

Once installed, simply run:

ray

PutmeIn will start as a resilient background daemon via PM2 and display your local and network dashboard URLs:

• Web Dashboard (Ray): http://localhost:4567
• API Engine (Brain): http://localhost:4500

Useful Links

• Website
• Documentation
• Discord

CLI Usage & Commands

PutmeIn exposes the ray command globally:

| Command | Description | |---|---| | ray or ray start | Starts Ray and Brain in the background via PM2 and displays dashboard URLs. | | ray stop | Gracefully stops the running background services. | | ray restart | Restarts all services with fresh state. | | ray status | Inspects running processes, PIDs, CPU usage, memory consumption, and port status. | | ray logs | Streams live unified output logs from both Ray and Brain. | | ray starter | Configures PutmeIn to start automatically on system boot (pm2 startup & pm2 save). | | ray --no-startup | Disables automatic startup on system boot. | | ray cohen | Launches the interactive terminal TUI client. | | ray --help | Displays help menu and command list. | | ray --version | Prints current installed version. |

Configuration

PutmeIn reads runtime configurations from ~/.putmein/.env or environment variables:

| Variable | Default | Description | |---|---|---| | RAY_PORT | 4567 | Port for the Ray web dashboard. | | BRAIN_PORT | 4500 | Port for the Brain AI backend engine. | | DATABASE_URL | — | MySQL / MariaDB connection string. | | BRAIN_INTERNAL_SECRET | auto-generated | Secret token for secure Brain <-> Ray communication. | | AGENT_AUTONOMOUS | false | Enable or disable autonomous DevOps action mode. |

Building From Source

# Clone the repository
git clone https://github.com/putme-in/putmein.git
cd putmein

# Install dependencies and build standalone distribution
npm run build

# Start services locally
npm start

Contibuting

If you found a bug, please create an issue with the title "Bug: " and a detailed description.

If you want to contribute to PutmeIn, please fork the repository and create a pull request.

Project Structure

• Brain: Backend of PutmeIn. Written in Go. Handles AI processing, Docker management, and core automation.
• Ray: Frontend of PutmeIn. Written in Next.js. Handles UI and user interaction.
• Cohen: CLI tool of PutmeIn. Written in Node.js. Handles CLI commands and user interaction.
• Landing: Landing page of PutmeIn. Written in Next.js. Handles landing page and user interaction.
• Docs: Documentation of PutmeIn. Written in Docusaurus. Handles documentation and user interaction.