asi1-mcp-cli


Nameasi1-mcp-cli JSON
Version 0.1.5 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-17 15:35:50
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/54/bc/2baa0e8baccc73345ab5eeddde103f7c983f98e962731a86375bfcf667e2/asi1_mcp_cli-0.1.5.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.5",
    "project_urls": null,
    "split_keywords": [
        "ai",
        " asi1",
        " chatbot",
        " cli",
        " langchain",
        " mcp"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "09ec5a84214a4e087c851e4d7846b0a9c384ad0a9c8ab4f2623775baf8fabfdc",
                "md5": "458f4b5dc4e4be7e7fddc272d9323281",
                "sha256": "e4beb6e8c08fc8c059273c3809ccafc7766efdd2ef1bbad4c6de596c88867b6a"
            },
            "downloads": -1,
            "filename": "asi1_mcp_cli-0.1.5-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "458f4b5dc4e4be7e7fddc272d9323281",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 22936,
            "upload_time": "2025-07-17T15:35:48",
            "upload_time_iso_8601": "2025-07-17T15:35:48.364104Z",
            "url": "https://files.pythonhosted.org/packages/09/ec/5a84214a4e087c851e4d7846b0a9c384ad0a9c8ab4f2623775baf8fabfdc/asi1_mcp_cli-0.1.5-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "54bc2baa0e8baccc73345ab5eeddde103f7c983f98e962731a86375bfcf667e2",
                "md5": "df79328ca43d481398b259f04511ba53",
                "sha256": "446e6fd1ed07cee3459613a254d515cd7590cd0e4bf1e92af75b13e39e71504c"
            },
            "downloads": -1,
            "filename": "asi1_mcp_cli-0.1.5.tar.gz",
            "has_sig": false,
            "md5_digest": "df79328ca43d481398b259f04511ba53",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 20686,
            "upload_time": "2025-07-17T15:35:50",
            "upload_time_iso_8601": "2025-07-17T15:35:50.086445Z",
            "url": "https://files.pythonhosted.org/packages/54/bc/2baa0e8baccc73345ab5eeddde103f7c983f98e962731a86375bfcf667e2/asi1_mcp_cli-0.1.5.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-17 15:35:50",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "asi1-mcp-cli"
}
        
Elapsed time: 0.42037s