ychatty


Nameychatty JSON
Version 0.1.0 PyPI version JSON
download
home_pageNone
SummaryA simple and friendly command-line chat interface with colorful output
upload_time2025-07-29 17:36:17
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseNone
keywords chat cli colorful interactive terminal
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # 🎉 chatty

A simple and friendly command-line chat interface with colorful output! 

chatty is a delightful CLI tool that provides an interactive chat-like experience with beautiful colors, emojis, and a friendly bot companion.

## ✨ Features

- 🤖 **Friendly AI-like responses** - Chat with a cheerful bot
- 🌈 **Beautiful colors** - Rich, colorful terminal output
- 😊 **Emoji support** - Fun emojis throughout the interface
- 📜 **Conversation history** - Keep track of your chat
- ⏰ **Time queries** - Ask for the current time
- 😄 **Jokes** - Request jokes for entertainment
- 🎨 **Rich formatting** - Tables, panels, and beautiful layouts
- 🚀 **Fast and lightweight** - Minimal dependencies

## 🚀 Installation

Install chatty directly from PyPI:

```bash
pip install chatty
```

Or install with uv:

```bash
uv add chatty
```

## 💬 Usage

### Basic Usage

Simply run chatty to start an interactive chat session:

```bash
chatty
```

### With Options

```bash
# Start with your name for a personalized experience
chatty --name "Alice"

# Start in quiet mode (no welcome message)
chatty --quiet

# Get help
chatty --help
```

### Example Conversation

```
🎉 Welcome to chatty! 🎉

💬 Type anything to chat with me!
🚪 Type 'bye', 'exit', or 'quit' to leave
📜 Type 'history' to see our conversation
❓ Type 'help' for more commands

You: Hello!
chatty: Hey! Great to see you! 😊

You: What time is it?
chatty: The current time is 14:30:25! ⏰

You: Tell me a joke
chatty: Why don't scientists trust atoms? Because they make up everything! 😄

You: bye
chatty: Goodbye! It was great chatting! 👋
```

## 🎮 Commands

- **General chat**: Just type anything to chat!
- **Time**: Ask "what time is it?" to get the current time
- **Jokes**: Say "tell me a joke" for a random joke
- **History**: Type "history" to see conversation history
- **Help**: Type "help" for command information
- **Exit**: Type "bye", "exit", or "quit" to leave

## 🛠️ Development

### Requirements

- Python 3.8+
- rich >= 13.0.0
- click >= 8.0.0

### Local Development

1. Clone the repository:
```bash
git clone https://github.com/zokrezyl/chatty.git
cd chatty
```

2. Install with uv:
```bash
uv sync
```

3. Run in development mode:
```bash
uv run chatty
```

### Building

Build the package:
```bash
uv build
```

## 📝 License

MIT License - see LICENSE file for details.

## 🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## 🐛 Issues

Found a bug or have a feature request? Please open an issue on GitHub.

## 🌟 Why chatty?

chatty was created to bring a bit of joy and color to the command line. Sometimes you just want to have a friendly conversation with your terminal! 

Whether you're taking a break from coding, testing terminal colors, or just want to chat with a friendly bot, chatty is here to brighten your day! ✨

---

Made with ❤️ by zokrezyl
            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "ychatty",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "chat, cli, colorful, interactive, terminal",
    "author": null,
    "author_email": "zokrezyl <zokrezyl@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/83/78/419b414cd6435dc16f741506f6ba48b21585914703a89cad1407bd69a51c/ychatty-0.1.0.tar.gz",
    "platform": null,
    "description": "# \ud83c\udf89 chatty\n\nA simple and friendly command-line chat interface with colorful output! \n\nchatty is a delightful CLI tool that provides an interactive chat-like experience with beautiful colors, emojis, and a friendly bot companion.\n\n## \u2728 Features\n\n- \ud83e\udd16 **Friendly AI-like responses** - Chat with a cheerful bot\n- \ud83c\udf08 **Beautiful colors** - Rich, colorful terminal output\n- \ud83d\ude0a **Emoji support** - Fun emojis throughout the interface\n- \ud83d\udcdc **Conversation history** - Keep track of your chat\n- \u23f0 **Time queries** - Ask for the current time\n- \ud83d\ude04 **Jokes** - Request jokes for entertainment\n- \ud83c\udfa8 **Rich formatting** - Tables, panels, and beautiful layouts\n- \ud83d\ude80 **Fast and lightweight** - Minimal dependencies\n\n## \ud83d\ude80 Installation\n\nInstall chatty directly from PyPI:\n\n```bash\npip install chatty\n```\n\nOr install with uv:\n\n```bash\nuv add chatty\n```\n\n## \ud83d\udcac Usage\n\n### Basic Usage\n\nSimply run chatty to start an interactive chat session:\n\n```bash\nchatty\n```\n\n### With Options\n\n```bash\n# Start with your name for a personalized experience\nchatty --name \"Alice\"\n\n# Start in quiet mode (no welcome message)\nchatty --quiet\n\n# Get help\nchatty --help\n```\n\n### Example Conversation\n\n```\n\ud83c\udf89 Welcome to chatty! \ud83c\udf89\n\n\ud83d\udcac Type anything to chat with me!\n\ud83d\udeaa Type 'bye', 'exit', or 'quit' to leave\n\ud83d\udcdc Type 'history' to see our conversation\n\u2753 Type 'help' for more commands\n\nYou: Hello!\nchatty: Hey! Great to see you! \ud83d\ude0a\n\nYou: What time is it?\nchatty: The current time is 14:30:25! \u23f0\n\nYou: Tell me a joke\nchatty: Why don't scientists trust atoms? Because they make up everything! \ud83d\ude04\n\nYou: bye\nchatty: Goodbye! It was great chatting! \ud83d\udc4b\n```\n\n## \ud83c\udfae Commands\n\n- **General chat**: Just type anything to chat!\n- **Time**: Ask \"what time is it?\" to get the current time\n- **Jokes**: Say \"tell me a joke\" for a random joke\n- **History**: Type \"history\" to see conversation history\n- **Help**: Type \"help\" for command information\n- **Exit**: Type \"bye\", \"exit\", or \"quit\" to leave\n\n## \ud83d\udee0\ufe0f Development\n\n### Requirements\n\n- Python 3.8+\n- rich >= 13.0.0\n- click >= 8.0.0\n\n### Local Development\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/zokrezyl/chatty.git\ncd chatty\n```\n\n2. Install with uv:\n```bash\nuv sync\n```\n\n3. Run in development mode:\n```bash\nuv run chatty\n```\n\n### Building\n\nBuild the package:\n```bash\nuv build\n```\n\n## \ud83d\udcdd License\n\nMIT License - see LICENSE file for details.\n\n## \ud83e\udd1d Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## \ud83d\udc1b Issues\n\nFound a bug or have a feature request? Please open an issue on GitHub.\n\n## \ud83c\udf1f Why chatty?\n\nchatty was created to bring a bit of joy and color to the command line. Sometimes you just want to have a friendly conversation with your terminal! \n\nWhether you're taking a break from coding, testing terminal colors, or just want to chat with a friendly bot, chatty is here to brighten your day! \u2728\n\n---\n\nMade with \u2764\ufe0f by zokrezyl",
    "bugtrack_url": null,
    "license": null,
    "summary": "A simple and friendly command-line chat interface with colorful output",
    "version": "0.1.0",
    "project_urls": {
        "Homepage": "https://github.com/zokrezyl/chatty",
        "Issues": "https://github.com/zokrezyl/chatty/issues",
        "Repository": "https://github.com/zokrezyl/chatty.git"
    },
    "split_keywords": [
        "chat",
        " cli",
        " colorful",
        " interactive",
        " terminal"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "4b1e1a7ce482a676bc1c4d5e7e1c7d48399b30c655b9b1abcb3b6c9a7476f7d9",
                "md5": "88e0504859dbdc5e9a22c2b56a7c501f",
                "sha256": "524a0f60ac520cda9b5d2829d953f34e1007d193d37689121d27dd869eb6a359"
            },
            "downloads": -1,
            "filename": "ychatty-0.1.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "88e0504859dbdc5e9a22c2b56a7c501f",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 6943,
            "upload_time": "2025-07-29T17:36:15",
            "upload_time_iso_8601": "2025-07-29T17:36:15.892289Z",
            "url": "https://files.pythonhosted.org/packages/4b/1e/1a7ce482a676bc1c4d5e7e1c7d48399b30c655b9b1abcb3b6c9a7476f7d9/ychatty-0.1.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "8378419b414cd6435dc16f741506f6ba48b21585914703a89cad1407bd69a51c",
                "md5": "2a555c7a5053984181d17ab94edaad25",
                "sha256": "241da7b67010c1fdcbfb681f2854878f4f41076ddecc7921622aae7ec9bdb92c"
            },
            "downloads": -1,
            "filename": "ychatty-0.1.0.tar.gz",
            "has_sig": false,
            "md5_digest": "2a555c7a5053984181d17ab94edaad25",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 11362,
            "upload_time": "2025-07-29T17:36:17",
            "upload_time_iso_8601": "2025-07-29T17:36:17.244516Z",
            "url": "https://files.pythonhosted.org/packages/83/78/419b414cd6435dc16f741506f6ba48b21585914703a89cad1407bd69a51c/ychatty-0.1.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-29 17:36:17",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "zokrezyl",
    "github_project": "chatty",
    "github_not_found": true,
    "lcname": "ychatty"
}
        
Elapsed time: 1.27320s