asi1-mcp-cli


Nameasi1-mcp-cli JSON
Version 0.1.6 PyPI version JSON
download
home_pageNone
SummaryA powerful CLI for interacting with the ASI:One LLM and Model Context Protocol (MCP) servers
upload_time2025-07-30 15:39:25
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseNone
keywords ai asi1 chatbot cli langchain mcp
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # FETCH.AI MCP CLI

## Quick Start

### Installation

```bash
pip install asi1-mcp-cli
```

### Setup

1. **Create configuration directory:**
   ```bash
   mkdir -p ~/.asi1
   ```

2. **Create configuration file:**
   ```bash
   # Copy the example config
   cp $(python -c "import asi1_mcp_cli; import os; print(os.path.join(os.path.dirname(asi1_mcp_cli.__file__), '..', 'asi1-mcp-server-config-example.json'))") ~/.asi1/config.json
   ```

3. **Edit the configuration:**
   ```bash
   nano ~/.asi1/config.json
   ```

   Update the following fields:
   - `api_key`: Your ASI:One API key
   - `BRAVE_API_KEY`: Your Brave Search API key (optional)

### Usage

#### Basic Conversation
```bash
asi1 "What is the capital of France?"
```

#### Web Search
```bash
asi1 "What are the latest developments in quantum computing?"
```

#### List Available Prompts
```bash
asi1 --list-prompts
```

#### Use Specific Prompt Templates
```bash
# Code review
asi1 --prompt review

# Git commit
asi1 --prompt commit

# YouTube video summary
asi1 --prompt yt --url "https://www.youtube.com/watch?v=example"
```

## Configuration

The configuration file (`~/.asi1/config.json`) supports:
- `api_key`: Your ASI:One API key
- `BRAVE_API_KEY`: Your Brave Search API key (optional)
- Other LLM/MCP server settings as needed

---

## ๐Ÿš€ Features

- **Beautiful CLI Header**: Eye-catching ASCII art and welcome message every time you start the CLI.
- **Agent Chat**: Send messages to other agents using `asi1 agent chat --address <agent_address> --message "..."`.
- **LLM/MCP Queries**: Use `asi1 <query>` or `asi1 run <query>` for natural language queries to the LLM or MCP server.
- **Prompt Templates**: Use pre-defined prompt templates for code review, commit messages, and YouTube summaries.
- **Backwards Compatible**: Old usage patterns still workโ€”no need to change your workflow!
- **Call Agent, MCP Server, and LLM**: The CLI can route your query to an agent, the MCP server, or the LLM as needed.

---

## ๐Ÿ–ฅ๏ธ Example Usage

### 1. Show the CLI header and help
```sh
asi1 --help
```

### 2. Ask the LLM or MCP server a question
```sh
asi1 What is the capital of France?
asi1 run "Build a chat bot in JavaScript and HTML"
```

### 3. Use a prompt template
```sh
asi1 run p review
asi1 run p commit
asi1 run p yt https://www.youtube.com/watch?v=dQw4w9WgXcQ
```

### 4. Chat with another agent
```sh
asi1 agent chat --address <agent_address> --message "Get the latest tweet from Elon Musk"
```

---

## ๐Ÿง  Prompt Templates

You can use prompt templates for common tasks:
- `review`: Code review for your current git diff
- `commit`: Generate a Conventional Commit message for your changes
- `yt`: Summarize a YouTube video by URL

Example:
```sh
asi1 run p yt https://www.youtube.com/watch?v=dQw4w9WgXcQ
```

---

## ๐Ÿ†• Recent Improvements
- Premium, colorful CLI header with FETCH.AI MCP CLI branding
- Agent chat with auto-exit after first response
- Backward compatibility for LLM/MCP queries
- Improved help and usage examples
- Prompt templates for review, commit, and YouTube summary

---

## ๐Ÿค Get Help
- Run `asi1 --help` for usage and examples
- For issues, open an issue on GitHub or contact the maintainers

---

Enjoy using the FETCH.AI MCP CLI! Powered by fetch.ai and ASI:One LLM.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "asi1-mcp-cli",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": "Fetch Team <gautam.kumar@fetch.ai>",
    "keywords": "ai, asi1, chatbot, cli, langchain, mcp",
    "author": null,
    "author_email": "Fetch Team <gautam.kumar@fetch.ai>",
    "download_url": "https://files.pythonhosted.org/packages/38/56/2fa675739fbd91bb1567caa7a530e71cb4902a5a93d31ff1fadc8a791a68/asi1_mcp_cli-0.1.6.tar.gz",
    "platform": null,
    "description": "# FETCH.AI MCP CLI\n\n## Quick Start\n\n### Installation\n\n```bash\npip install asi1-mcp-cli\n```\n\n### Setup\n\n1. **Create configuration directory:**\n   ```bash\n   mkdir -p ~/.asi1\n   ```\n\n2. **Create configuration file:**\n   ```bash\n   # Copy the example config\n   cp $(python -c \"import asi1_mcp_cli; import os; print(os.path.join(os.path.dirname(asi1_mcp_cli.__file__), '..', 'asi1-mcp-server-config-example.json'))\") ~/.asi1/config.json\n   ```\n\n3. **Edit the configuration:**\n   ```bash\n   nano ~/.asi1/config.json\n   ```\n\n   Update the following fields:\n   - `api_key`: Your ASI:One API key\n   - `BRAVE_API_KEY`: Your Brave Search API key (optional)\n\n### Usage\n\n#### Basic Conversation\n```bash\nasi1 \"What is the capital of France?\"\n```\n\n#### Web Search\n```bash\nasi1 \"What are the latest developments in quantum computing?\"\n```\n\n#### List Available Prompts\n```bash\nasi1 --list-prompts\n```\n\n#### Use Specific Prompt Templates\n```bash\n# Code review\nasi1 --prompt review\n\n# Git commit\nasi1 --prompt commit\n\n# YouTube video summary\nasi1 --prompt yt --url \"https://www.youtube.com/watch?v=example\"\n```\n\n## Configuration\n\nThe configuration file (`~/.asi1/config.json`) supports:\n- `api_key`: Your ASI:One API key\n- `BRAVE_API_KEY`: Your Brave Search API key (optional)\n- Other LLM/MCP server settings as needed\n\n---\n\n## \ud83d\ude80 Features\n\n- **Beautiful CLI Header**: Eye-catching ASCII art and welcome message every time you start the CLI.\n- **Agent Chat**: Send messages to other agents using `asi1 agent chat --address <agent_address> --message \"...\"`.\n- **LLM/MCP Queries**: Use `asi1 <query>` or `asi1 run <query>` for natural language queries to the LLM or MCP server.\n- **Prompt Templates**: Use pre-defined prompt templates for code review, commit messages, and YouTube summaries.\n- **Backwards Compatible**: Old usage patterns still work\u2014no need to change your workflow!\n- **Call Agent, MCP Server, and LLM**: The CLI can route your query to an agent, the MCP server, or the LLM as needed.\n\n---\n\n## \ud83d\udda5\ufe0f Example Usage\n\n### 1. Show the CLI header and help\n```sh\nasi1 --help\n```\n\n### 2. Ask the LLM or MCP server a question\n```sh\nasi1 What is the capital of France?\nasi1 run \"Build a chat bot in JavaScript and HTML\"\n```\n\n### 3. Use a prompt template\n```sh\nasi1 run p review\nasi1 run p commit\nasi1 run p yt https://www.youtube.com/watch?v=dQw4w9WgXcQ\n```\n\n### 4. Chat with another agent\n```sh\nasi1 agent chat --address <agent_address> --message \"Get the latest tweet from Elon Musk\"\n```\n\n---\n\n## \ud83e\udde0 Prompt Templates\n\nYou can use prompt templates for common tasks:\n- `review`: Code review for your current git diff\n- `commit`: Generate a Conventional Commit message for your changes\n- `yt`: Summarize a YouTube video by URL\n\nExample:\n```sh\nasi1 run p yt https://www.youtube.com/watch?v=dQw4w9WgXcQ\n```\n\n---\n\n## \ud83c\udd95 Recent Improvements\n- Premium, colorful CLI header with FETCH.AI MCP CLI branding\n- Agent chat with auto-exit after first response\n- Backward compatibility for LLM/MCP queries\n- Improved help and usage examples\n- Prompt templates for review, commit, and YouTube summary\n\n---\n\n## \ud83e\udd1d Get Help\n- Run `asi1 --help` for usage and examples\n- For issues, open an issue on GitHub or contact the maintainers\n\n---\n\nEnjoy using the FETCH.AI MCP CLI! Powered by fetch.ai and ASI:One LLM.\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "A powerful CLI for interacting with the ASI:One LLM and Model Context Protocol (MCP) servers",
    "version": "0.1.6",
    "project_urls": null,
    "split_keywords": [
        "ai",
        " asi1",
        " chatbot",
        " cli",
        " langchain",
        " mcp"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "1735320665ae2017ffd7715a1cd3d73a874d2834a5035bba021b63662c1bec54",
                "md5": "46b2a073b714bc112e9f98941f43acf5",
                "sha256": "083e7f796132a7644e852d4ba9ac7d15208f181a09deff364b494a7b64bab1b1"
            },
            "downloads": -1,
            "filename": "asi1_mcp_cli-0.1.6-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "46b2a073b714bc112e9f98941f43acf5",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 23181,
            "upload_time": "2025-07-30T15:39:20",
            "upload_time_iso_8601": "2025-07-30T15:39:20.030582Z",
            "url": "https://files.pythonhosted.org/packages/17/35/320665ae2017ffd7715a1cd3d73a874d2834a5035bba021b63662c1bec54/asi1_mcp_cli-0.1.6-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "38562fa675739fbd91bb1567caa7a530e71cb4902a5a93d31ff1fadc8a791a68",
                "md5": "8ed5d1ccce6c3af6c9975be201660957",
                "sha256": "db8771843a455f55d9b12749dabea859e67a38bb7d6abf90dc4b92f9bbfe46bf"
            },
            "downloads": -1,
            "filename": "asi1_mcp_cli-0.1.6.tar.gz",
            "has_sig": false,
            "md5_digest": "8ed5d1ccce6c3af6c9975be201660957",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 20546,
            "upload_time": "2025-07-30T15:39:25",
            "upload_time_iso_8601": "2025-07-30T15:39:25.477369Z",
            "url": "https://files.pythonhosted.org/packages/38/56/2fa675739fbd91bb1567caa7a530e71cb4902a5a93d31ff1fadc8a791a68/asi1_mcp_cli-0.1.6.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-30 15:39:25",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "asi1-mcp-cli"
}
        
Elapsed time: 0.50348s