Python good first issues

10,612 open Python issues currently match the default 10+ star filter. Scored difficulty: 5,947 at 1/5, 8,788 at 2/5, 12,702 at 3/5, 12,124 at 4/5, 857 at 5/5. This hub uses the same feed as the homepage, limited to repositories whose GitHub language is Python.

All languages · Browse projects · How to find good first issues

Active projects

Unique repos with open help-wanted issues updated in the last 30 days

Showing 30 of ~10,612 matching filters (Python · 10+ stars)

List

CLI installer: `itqan install` — sync manifest deps into assets/ folder

AI summary

This issue proposes the development of a CLI command, `itqan install`, which will function as a package manager for Itqan assets. It will read an asset manifest, resolve dependencies against a package registry, download artifacts, and materialize them into an `assets/` folder, providing a reproducible local development environment.

EnhancementHelp WantedBackendepic: itqan-dependabotroadmap: 1448
10
Difficulty
4/5

Refactor Type Checking Imports

AI summary

This issue proposes refactoring `TYPE_CHECKING` imports within the `icalendar` library. The goal is to switch from importing classes directly from their implementation modules to using the public exports available in `icalendar.cal`. This change aims to improve consistency with the public API and reduce coupling to internal module structure, without affecting runtime behavior.

help wantedgood first issuehacktoberfest
1.1K
Difficulty
2/5

Help wanted: translations — Spanish next, and any language after

AI summary

The NeverDry project is seeking volunteers to review and correct AI-generated translations for Spanish and French. The project already has English and Italian translations, with German in progress. Volunteers do not need development experience and can submit corrections in a comfortable format.

enhancementhelp wantedgood first issue
50
Difficulty
2/5

Feature AI Question Builder

AI summary

The user is requesting a feature enhancement for the AI Question Builder in Open edX. They want to be able to save generated questions into pre-existing collections within a library, rather than always creating new collections from scratch. This would improve organization and reusability of generated content.

good first issueenhancement
16
Difficulty
3/5

1.4.3 的 funasr/bin/realtime_ws.py 的 run_session_work() 实现太简单粗暴,导致并发性能比1.3.9还差很多

AI summary

The user reports a significant decrease in concurrent performance in version 1.4.3 of the FunASR WebSocket service compared to version 1.3.9. They attribute this to an overly aggressive locking mechanism in the `run_session_work` function, which serializes all operations, including non-model-related ones, and prevents vLLM's batching capabilities from being utilized effectively.

bughelp wanted
18.9K
Difficulty
4/5

Document every MCP tool's parameters in one reference table

AI summary

This issue requests the addition of a comprehensive tool parameters table to the project's README.md. Currently, tool parameters are only documented within the Python source code, making it difficult for users to discover them. The new table will consolidate information about each tool's parameters, including their type, default values, and descriptions, directly into the documentation.

help wantedgood first issue
20
Difficulty
2/5

Test explicit `OpenAPIConfig.security` definition with `auth=None` per-endpoint

AI summary

This issue identifies a potential bug in how OpenAPI security definitions are handled, specifically when `auth=None` is defined per endpoint. The current implementation incorrectly returns `None` instead of an empty list `[]` when per-document security is set, leading to incorrect inheritance of security rules. A test and a fix are required to address this behavior.

buggood first issuehelp wantedopenapiopensource september
1.3K
Difficulty
2/5

[Performance][Diffusion] Boogu-Image roadmap: full model-series support, feature optimizations, and hardware-specific optimizations

AI summary

This issue outlines a roadmap for improving the Boogu-Image diffusion model, focusing on expanding hardware support (multi-GPU, CPU offload, Ascend NPU, AMD, Intel), and optimizing performance through features like distilled variants, FP8 checkpoints, and cache acceleration. The goal is to bring the capabilities of the upstream reference implementation to the current native implementation.

help wantedgood first issuediffusion
3.2K
Difficulty
4/5

Add redaction regression tests for run-record evidence

AI summary

This issue proposes adding regression tests to ensure that sensitive information is properly redacted in run-record evidence. The goal is to create lightweight tests that cover common secret patterns without requiring real credentials or external services, ensuring the redaction logic remains robust.

good first issuetesting
78
Difficulty
2/5

Auto-run code suggested by AI

AI summary

This issue proposes an enhancement to the AI completion feature in Marimo. Currently, users must manually accept AI-generated code before running it, which disrupts workflow and hinders iteration. The suggested solution is to automatically run the AI-suggested code while keeping the completion interface open, allowing users to immediately see the output and iterate more efficiently.

enhancementgood first issuegood first issue (typescript)needs discussion
21.7K
Difficulty
3/5

[Docs] Translate the new CONTRIBUTING.md intro into the twelve locale files

AI summary

This issue requires translating the updated introductory sections of the `CONTRIBUTING.md` file into twelve different locales. The goal is to ensure consistency across all language versions, replacing the old Docker-focused introduction with the new content about picking work, docs-only paths, and quality bars.

documentationgood first issue
3.7K
Difficulty
2/5

govern audit: a built-in check reports every capability with more than one implementation

AI summary

This issue proposes adding a built-in audit check to identify capabilities with more than one implementation. Currently, such checks only happen during CI runs and are not visible to operators. The goal is to create a persistent, operator-visible report that counts specific capability types and flags any deviations from the expected single implementation, ensuring deterministic findings.

good first issuesize/sP2up-for-grabsgovernance
661
Difficulty
3/5

[Bounty][$0][Ops] 重建 lessons/index.md 并加 --check 门禁(当前 181 条里 25 条悬空、136 条标题不符)

AI summary

This issue addresses significant drift and fragility in the `lessons/index.md` file, which serves as a course directory. The core task is to create a new script to rebuild this file from source lesson files, ensuring consistency with frontmatter data for titles, domains, and tags. The script will include a `--check` mode to detect inconsistencies and will be integrated into an existing daily workflow for automatic updates, rather than adding a new PR gate.

help wantedreadyarea:lessonsarea:scriptsbountyagent-friendly
204
Difficulty
3/5

Add docs/integrations/claude-code.md

AI summary

This issue requests the creation of a new documentation page for the Claude Code IDE integration within Observal. The page should detail supported features, installation instructions, configuration paths, hook behavior, and any known limitations to help users understand and set up the integration.

documentationgood first issue
2.1K
Difficulty
2/5

🌞 Testers wanted: solar and heat-pump installations

AI summary

The project is seeking volunteers with specific Bosch solar and/or heat pump installations to provide diagnostic data. This data is crucial for developing and testing support for these systems within the POINTTAPI integration, as real-world examples are currently lacking.

help wanted
14
Difficulty
2/5

xai: reasoning_effort sent to all Grok models returns HTTP 400 on unsupported ones

AI summary

The system incorrectly sends the `reasoning_effort` parameter to all Grok models, even those that do not support it, resulting in HTTP 400 errors. The fix involves implementing a check to ensure `reasoning_effort` is only sent to Grok models that explicitly support it, while other providers retain their current behavior.

Bughelp wantedcomp:serverP2-mediumtriagedreview-sla-escalated
5.9K
Difficulty
2/5

Call for testing: verify VoxCode dashboard integration on macOS

AI summary

This issue requests testers to verify the integration of the VoxCode dashboard on macOS. The goal is to confirm its functionality, document a working setup, or identify any blockers. Testers need to record their environment details and follow a checklist to test various features like microphone selection, push-to-talk, real-time transcription, and dashboard persistence.

help wantedgood first issue
26
Difficulty
3/5

[Feature] Replace nested tensor logic with pytree

AI summary

This issue proposes replacing custom logic for flattening and unflattening nested tensor structures in LLM Compressor and Compressed Tensors with the more robust `torch.utils._pytree` module. The goal is to improve code reliability and potentially simplify existing implementations by leveraging a standard library function.

enhancementgood first issuegood follow-up issue
3.5K
Difficulty
3/5

Add regression tests for scheduler service

AI summary

This issue requests the addition of regression tests for the scheduler service to ensure its core functionality remains stable. The goal is to cover the primary success scenarios and the most probable edge cases that could break. The recommendation is to prioritize focused unit tests with a single integration test if necessary.

good first issuetype:testinglevel:beginnertype:platform-backend
77
Difficulty
2/5

[ONBOARD: 3 RTC] Test the Miner and Post Your Hardware Report

AI summary

This issue is a bounty for users to test the RustChain miner in dry-run mode and report their hardware specifications and any encountered issues. The goal is to gather compatibility data across a wide range of hardware, with bonus points for exotic architectures.

good first issuebountyonboardingminer
89
Difficulty
1/5

Remove MLflow 2.x scaffolding left behind by the mlflow>=3.13 floor

AI summary

This issue proposes removing two pieces of scaffolding code related to MLflow 2.x that are no longer necessary due to an updated MLflow version floor (>=3.13.0). The first is a dead code branch in `log_sklearn_model_compatible` and the second is a dummy Databricks config profile fixture used for a workaround that is now resolved.

good first issueDQX Core
436
Difficulty
1/5

soup sweep ranks a diverged arm by a NaN key, so it lands anywhere in the leaderboard

AI summary

This issue describes a bug in the sweep ranking logic where `NaN` values for `final_loss` cause diverged runs to be incorrectly positioned in leaderboards. The fix involves ensuring that non-finite `final_loss` values are consistently sorted last and that diverged arms are explicitly reported as such, rather than being silently ignored or misplaced.

bughelp wanted
72
Difficulty
3/5

Decode Discord /channels/ links offline

AI summary

This issue proposes adding a new module to decode Discord channel links offline. The module should extract Discord snowflake IDs from the URL path and derive their creation timestamps, similar to how Telegram links are handled. The goal is to provide the guild ID, channel ID, message ID, and timestamps without requiring any network requests or Discord credentials.

good first issue
224
Difficulty
2/5

govern audit: an injectable failure sentinel proves the detect, record, notify path end to end

AI summary

This issue proposes adding a "failure sentinel" to the govern audit system. This sentinel, likely a file or environment variable, will simulate a failure in a specific check, allowing the entire detect, record, and notify process to be tested end-to-end without impacting real system state. The acceptance criteria ensure the sentinel is properly reported and that the selftest suite can effectively use it to verify the audit path.

enhancementgood first issuesize/sP2up-for-grabsgovernance
661
Difficulty
2/5

[BOUNTY] Register Your Agent on Beacon Atlas - 3 RTC

AI summary

This bounty issue asks users to register an AI agent on the Beacon Atlas, RustChain's agent discovery network. The process involves installing a Python package, generating an agent identity, registering the agent with a name and description, and sending a "hello" message. A bonus is offered for keeping the agent alive for 24 hours.

help wantedgood first issuebounty
89
Difficulty
2/5

Feature: Multi-hop document-RAG for cross-document questions

AI summary

This issue proposes enhancing the Document-RAG system to support multi-hop retrieval for questions that require information from multiple documents or scattered across different sections. The proposed design involves an iterative loop where the LLM can issue follow-up queries based on initial retrieval results until sufficient context is gathered to synthesize a comprehensive answer.

enhancementhelp wantedsize: large
2.2K
Difficulty
4/5

[Bounty][$0][Lessons] 把 intake #1553(alembic upgrade 失败)转成课程

AI summary

This issue requests the creation of a new course document explaining how to diagnose and resolve Alembic database migration failures. The course should cover common causes like SQL errors, model/migration script mismatches, and permission issues, providing practical commands and verification steps for troubleshooting.

good first issuereadyarea:corebountyagent-friendlyzero-bounty
204
Difficulty
3/5

[Bounty][$0][Lessons] 把 intake #1555(nano-gpt.com SSE 流式调用失败)转成课程

AI summary

This issue requests the creation of a new course based on a previously reported failure in calling nano-gpt.com's SSE streaming API via the OpenRouter SDK. The course should detail the problem, its root causes (like intermediate buffering or incorrect parsing of SSE streams), and provide solutions including correct request headers, data frame parsing, and handling proxy buffering. It also requires a runnable verification script.

good first issuereadyarea:corebountyagent-friendlyzero-bounty
204
Difficulty
4/5

Also browsing: TypeScript , JavaScript , Rust