Skip to content

Ayushman2004/cerci

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Cerci: AI-Powered Linux Systems Assistant

Overview

Cerci is an intelligent systems assistant designed to streamline and enhance the user experience on Linux systems. By leveraging AI, Cerci translates user requests into actionable terminal commands and executes them seamlessly. The assistant communicates with an AI server via the Groq API using curl and handles command execution through system calls in Linux.

Key Features

  • AI-Powered Command Generation: Cerci uses AI to interpret user requests and generate the appropriate bash commands.
  • Seamless API Integration: Communicates with an AI server using HTTP requests via curl.
  • Efficient Command Execution: Executes terminal commands using system calls in Linux.
  • User-Friendly: Simplifies complex tasks by abstracting command syntax and operations.

How It Works

  1. User Input: The user provides a natural language request specifying the task they want to perform in the terminal.
  2. AI Query: Cerci sends the user request to the AI server via the Groq API using curl.
  3. Response Handling: Cerci receives the AI-generated bash command.
  4. Command Execution: The command is executed directly using Linux system calls.

Installation

Prerequisites

  • Linux operating system
  • C++ compiler (e.g., g++)
  • curl installed

Build Instructions

  1. Clone the repository:

    git clone https://github.com/Ayushman2004/cerci.git
    cd cerci
  2. Compile the source code:

    mkdir build
    cd build
    cmake ..
    make
  3. Run the executable:

    ./cerci <request>

Usage

  1. Set up Groq API ans API_key
  2. Cerci launch and request:
    ./cerci create a new directory called projects
  3. Cerci will generate and execute the corresponding bash command:
    mkdir projects

Example Scenarios

  • File Management:

    ./cerci Delete all files with the .log extension in the current directory
    

    Cerci executes:

    rm *.log
  • System Monitoring:

    ./cerci show me the current CPU usage
    

    Cerci executes:

    top

Security Considerations

  • Be cautious when executing commands generated by Cerci, especially commands that modify or delete files.
  • Ensure the AI server and Groq API endpoints are secure.

Future Enhancements

  • Enhanced natural language processing capabilities.
  • Improved error handling and logging.

License

This project is licensed under the Apahe-2.0 LICENSE.

Acknowledgment

  • Groq API for AI capabilities

Cerci empowers Linux users and DevOps Engineers by simplifying terminal operations and making system management more accessible through AI-driven automation.

About

Cerci is a LLM powered AI systems assistance software which helps users with the usage of Natural Language at the terminal CLI.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors