Assistant IA: Your AI‑powered command‑line assistant to generate and execute Bash commands from natural language.
Maintained by YourName.

Assistant IA is a command‑line tool written in Python that leverages an AI API to convert natural language requests into executable Bash commands. With built‑in instruction management, API integration, and a command queue, Assistant IA helps you quickly automate routine tasks without leaving the terminal.

• AI‑Powered Command Generation
  Send natural language instructions (e.g., “ping google”) and receive a ready‑to‑execute Bash command.

• Instruction Management
  Create, list, and remove custom instructions that are stored as text files for reuse and context.

• Command Queueing
  Queue commands for later execution with the ia execall command.

• API Integration
  Easily link your chosen AI model and API key with ia link <model> apikey <key>.
  Integrates with Tavily for searching and updating instructions.

• Simple Installation
  An installation script (install.sh) sets up the tool in /opt/assistant and creates a global symlink (/usr/local/bin/ia).

• A Debian‑based system (or compatible Linux distribution)
• Python 3 and pip
• Internet access to reach the AI API and, optionally, the Tavily API

Clone the repository and run the installer:

git clone https://github.com/YourUsername/assistant-ia.git
cd assistant-ia
chmod +x install.sh
./install.sh

This will:

• Update your system packages
• Install Python3 and pip
• Copy the ia.py script to /opt/assistant
• Create a symlink so that you can run the tool globally using the command ia

Once installed, you can interact with Assistant IA via your terminal. Below are some example commands:

• Generate a Command:

  ia do "list all files in the current directory"

  This sends your natural language request to the API and displays the generated Bash command. You can choose to execute it immediately, add it to a queue, or cancel.

• Create an Instruction:

  ia create instruction my_command

  This starts an interactive session to save a custom command (or script) as an instruction for future context.

• Remove an Instruction:

  ia remove instruction my_command

• Link Your API Keys:
  Configure the AI model and API key:

  ia link deepseek-r1 apikey YOUR_API_KEY

  And set your Tavily API key:

  ia tavily link YOUR_TAVILY_API_KEY

• Execute Queued Commands:

  ia execall

• Run a Test Request:

  ia test

For a full list of commands and options, simply run:

ia

• Configuration File:
  The AI model and API keys are stored in ai_config.json (located in your home directory under ~/assistant).

• Instructions:
  Custom instructions are saved as text files inside the instructions/ folder.

Contributions are welcome! If you’d like to improve Assistant IA, please fork the repository and open a pull request. For major changes, please open an issue first to discuss your ideas.

If you encounter any issues or have feature suggestions, please open an issue on GitHub.

Happy automating with Assistant IA!

Feel free to customize the content (especially the placeholder links, images, and your maintainer details) to match your project and style preferences. Enjoy sharing your project on GitHub!