{"id":31529601,"url":"https://github.com/aimldev726/ieltscli","last_synced_at":"2026-04-14T00:02:26.122Z","repository":{"id":313072423,"uuid":"1049921433","full_name":"AIMLDev726/IELTSCLI","owner":"AIMLDev726","description":"A command-line tool for realistic IELTS writing practice, offering intelligent prompt generation, band-score assessments, and improvement feedback.","archived":false,"fork":false,"pushed_at":"2025-09-03T17:56:32.000Z","size":97,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-09-27T22:29:47.637Z","etag":null,"topics":["ai","cli","gemini","genai","google","ielts","llm","ollama","openai","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AIMLDev726.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-03T17:30:46.000Z","updated_at":"2025-09-03T17:59:24.000Z","dependencies_parsed_at":"2025-09-03T19:53:21.264Z","dependency_job_id":null,"html_url":"https://github.com/AIMLDev726/IELTSCLI","commit_stats":null,"previous_names":["aimldev726/ieltscli"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/AIMLDev726/IELTSCLI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AIMLDev726%2FIELTSCLI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AIMLDev726%2FIELTSCLI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AIMLDev726%2FIELTSCLI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AIMLDev726%2FIELTSCLI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AIMLDev726","download_url":"https://codeload.github.com/AIMLDev726/IELTSCLI/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AIMLDev726%2FIELTSCLI/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278250925,"owners_count":25955991,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-03T02:00:06.070Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","cli","gemini","genai","google","ielts","llm","ollama","openai","python"],"created_at":"2025-10-04T01:10:35.859Z","updated_at":"2025-10-04T01:10:37.061Z","avatar_url":"https://github.com/AIMLDev726.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# IELTS Practice CLI 🎯\n\nA powerful command-line tool for IELTS writing practice with intelligent assessment and detailed feedback.\n\n## 🌟 What This Tool Does\n\nThis application helps IELTS candidates practice writing tasks by:\n- Generating realistic IELTS prompts\n- Providing detailed band score assessments\n- Tracking progress over multiple sessions\n- Offering specific improvement suggestions\n\nPerfect for students preparing for IELTS Academic and General Training writing modules.\n\n## 📋 Requirements\n\n- Python 3.8 or higher\n- An API key from one of these providers:\n  - **OpenAI** (recommended for best results)\n  - **Google AI** (Gemini models)\n  - **Ollama** (for local/offline use)\n\n## 🚀 Quick Setup\n\n### Step 1: Download and Install\n\n```bash\n# Download the project\ngit clone https://github.com/AIMLDev726/IELTSCLI.git\ncd IELTSCLI\n\n# Install required packages\npip install -r requirements.txt\n```\n\n### Step 2: Get an API Key\n\n**Option A: OpenAI (Recommended)**\n1. Go to [OpenAI Platform](https://platform.openai.com)\n2. Create an account or sign in\n3. Navigate to \"API Keys\" section\n4. Create a new API key\n5. Copy the key (starts with `sk-`)\n\n**Option B: Google AI**\n1. Visit [Google AI Studio](https://makersuite.google.com)\n2. Sign in with your Google account\n3. Click \"Get API Key\"\n4. Create a new API key\n5. Copy the key\n\n**Option C: Local Setup (Ollama)**\n1. Install [Ollama](https://ollama.ai)\n2. Run: `ollama pull llama2`\n3. No API key needed\n\n### Step 3: First Run\n\n```bash\npython main.py\n```\n\nThe application will guide you through the initial setup.\n\n## 📚 How to Use\n\n### Starting Your First Practice Session\n\n```bash\n# Start a Writing Task 2 practice\npython main.py practice --type writing_task_2\n```\n\n### During Practice\n\n1. **Read the prompt** carefully\n2. **Write your response** (minimum 250 words for Task 2)\n3. **Type `SUBMIT`** on a new line when finished\n4. **Review your assessment** with band scores and feedback\n\n### Example Session\n\n```\n$ python main.py practice --type writing_task_2\n\n📋 Task Prompt:\nSome people believe that technology is making traditional teachers less important \nin education. Others argue that teachers are more crucial than ever.\n\nDiscuss both views and give your opinion.\nWrite at least 250 words.\n\nYour response:\nTechnology has transformed many aspects of our lives, including education...\n\n[Continue writing your essay]\n\nSUBMIT\n\n🎯 Assessment Results:\nOverall Band Score: 6.5\n\nTask Achievement: 7.0\n- Clear position with relevant examples\n- Well-developed response to the prompt\n\nCoherence and Cohesion: 6.0\n- Good paragraph structure\n- Could use more linking words\n\n[Detailed feedback continues...]\n```\n\n## 🎯 Features\n\n### ✅ What You Get\n\n- **Realistic IELTS prompts** generated specifically for your practice\n- **Detailed band scores** for all four assessment criteria\n- **Specific feedback** on what to improve\n- **Progress tracking** across multiple sessions\n- **Word count monitoring** during writing\n- **Time tracking** to simulate exam conditions\n\n### 📊 Assessment Criteria\n\nThe tool evaluates your writing based on official IELTS criteria:\n\n**Writing Task 2:**\n- Task Response (25%)\n- Coherence and Cohesion (25%) \n- Lexical Resource (25%)\n- Grammatical Range and Accuracy (25%)\n\n**Writing Task 1:**\n- Task Achievement (25%)\n- Coherence and Cohesion (25%)\n- Lexical Resource (25%)\n- Grammatical Range and Accuracy (25%)\n\n## 📖 Commands Reference\n\n### Basic Commands\n\n```bash\n# Start practice session\npython main.py practice --type writing_task_2\n\n# View recent sessions\npython main.py sessions\n\n# Check configuration\npython main.py config --show\n\n# Test API connection\npython main.py test\n```\n\n### Advanced Options\n\n```bash\n# Practice with time limit\npython main.py practice --type writing_task_2 --time 40\n\n# Quick practice (no assessment)\npython main.py practice --quick\n\n# Resume previous session\npython main.py practice --resume SESSION_ID\n\n# Export session data\npython main.py sessions --export my_sessions.json\n\n# View detailed statistics\npython main.py stats --detailed\n```\n\n## 🔧 Configuration\n\n### Change AI Provider\n\n```bash\n# Switch to OpenAI\npython main.py config --provider openai --api-key YOUR_KEY\n\n# Switch to Google AI\npython main.py config --provider google --api-key YOUR_KEY\n\n# Switch to local Ollama\npython main.py config --provider ollama\n```\n\n### Customize Settings\n\n```bash\n# Set default task type\npython main.py config --set task_type --value writing_task_2\n\n# Enable detailed feedback\npython main.py config --set show_detailed_feedback --value true\n\n# Set default time limit\npython main.py config --set default_time_limit --value 40\n```\n\n## 🗂️ Project Structure\n\n```\nIELTSCLI/\n├── src/\n│   ├── cli/                 # User interface components\n│   ├── core/                # Core application logic\n│   ├── llm/                 # AI provider integration\n│   ├── assessment/          # IELTS scoring engine\n│   ├── storage/             # Data management\n│   └── utils/               # Helper functions\n├── docs/                    # Documentation\n├── tests/                   # Test files\n├── main.py                  # Application entry point\n├── requirements.txt         # Python dependencies\n└── setup.py                # Installation configuration\n```\n\n## 🛠️ Troubleshooting\n\n### Common Issues\n\n**\"No API key configured\"**\n```bash\npython main.py config --provider openai --api-key YOUR_KEY\n```\n\n**\"Connection failed\"**\n```bash\npython main.py test --connection\n```\n\n**\"Import errors\"**\n```bash\npip install -r requirements.txt\n```\n\n**\"Permission denied\"**\n- Run terminal as administrator (Windows)\n- Use `sudo` if needed (Mac/Linux)\n\n### Getting Help\n\n```bash\n# General help\npython main.py --help\n\n# Command-specific help\npython main.py practice --help\npython main.py config --help\n```\n\n## 📊 Example Band Scores\n\nHere's what different performance levels look like:\n\n**Band 8-9 (Excellent)**\n- Clear, well-developed arguments\n- Wide range of vocabulary\n- Complex sentence structures\n- Minimal errors\n\n**Band 6-7 (Good)**\n- Clear position with examples\n- Good vocabulary range\n- Mix of simple and complex sentences\n- Some minor errors\n\n**Band 4-5 (Needs Work)**\n- Basic task response\n- Limited vocabulary\n- Simple sentences mostly\n- Frequent errors affecting meaning\n\n## 🤝 Contributing\n\nWe welcome contributions! Here's how to help:\n\n1. Fork this repository\n2. Create a new branch for your feature\n3. Make your changes\n4. Test thoroughly\n5. Submit a pull request\n\n## 📄 License\n\nThis project is open source under the MIT License.\n\n## 📞 Support\n\n- **Email**: aistudentlearn4@gmail.com\n- **GitHub Issues**: [Report problems here](https://github.com/AIMLDev726/IELTSCLI/issues)\n- **Documentation**: Check the `docs/` folder for detailed guides\n\n---\n\n**Start practicing today and improve your IELTS writing scores! 🎯**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faimldev726%2Fieltscli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faimldev726%2Fieltscli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faimldev726%2Fieltscli/lists"}