{"id":45552,"library":"nextcord","title":"Nextcord","description":"Nextcord is a modern, asynchronous Python wrapper for the Discord API, forked from discord.py after v1.7.3. It aims to keep compatibility while adding new Discord features. Current version is 3.2.0, supporting Python 3.12+. Release cadence is irregular, with major updates roughly yearly.","status":"active","version":"3.2.0","language":"python","source_language":"en","source_url":"https://github.com/nextcord/nextcord","tags":["discord","api","bot","async"],"install":[{"cmd":"pip install nextcord","lang":"bash","label":"Install from PyPI"},{"cmd":"pip install nextcord[voice]","lang":"bash","label":"Install with voice support"}],"dependencies":[{"reason":"Required for HTTP requests to Discord API.","package":"aiohttp","optional":false},{"reason":"Used by aiohttp for URL handling.","package":"yarl","optional":false}],"imports":[{"note":"Nextcord is a fork; using discord.py imports will fail at runtime.","symbol":"Client","correct":"from nextcord import Client"},{"note":"Intents must be explicitly enabled. Mistake: omitting intents, resulting in empty cache.","symbol":"Intents","correct":"from nextcord import Intents"},{"note":"Embed construction is same as discord.py but import path differs.","symbol":"Embed","correct":"from nextcord import Embed"}],"quickstart":{"code":"import nextcord\nfrom nextcord.ext import commands\n\nbot = commands.Bot(command_prefix='!', intents=nextcord.Intents.default())\n\n@bot.event\nasync def on_ready():\n    print(f'Logged in as {bot.user}')\n\n@bot.command()\nasync def ping(ctx):\n    await ctx.send('Pong!')\n\nbot.run('TOKEN')\n","lang":"python","description":"Basic bot with command prefix and ready event. Replace 'TOKEN' with your bot token."},"warnings":[{"fix":"Install Python 3.12 or newer, then upgrade nextcord.","message":"Nextcord 2.0+ dropped support for Python <3.8. Nextcord 3.0+ requires Python >=3.12. Upgrade your Python version if using older releases.","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Replace attachment.url with attachment.proxy_url or attachment.url after enabling the new intent.","message":"Attachments now have a different API: attachment.url is no longer available; use attachment.proxy_url or attachment.url returns the CDN URL but requires intent changes.","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"1. Enable 'Server Members Intent' and 'Presence Intent' in Discord Developer Portal. 2. Pass intents=nextcord.Intents.all() or intents=nextcord.Intents(members=True, presences=True) to your bot/client.","message":"Members and presence intents are now privileged. If your bot does not see members, you likely forgot to enable them in the Discord Developer Portal and in code.","severity":"gotcha","affected_versions":"all"},{"fix":"Replace `case_insensitive=True` with `command_prefix=lambda bot, msg: '!' if ... else '?'` or use discord.py style `when_mentioned`.","message":"The `nextcord.ext.commands.Bot` constructor parameter `case_insensitive` is deprecated; use `case_insensitive=True` inside `command_prefix` as a callable instead.","severity":"deprecated","affected_versions":"<3.0.0"}],"env_vars":null,"search_vec":"'3.12':34 '3.2.0':31 'ad':24 'aim':19 'api':12,45 'async':47 'asynchron':6 'bot':46 'cadenc':36 'compat':22 'current':28 'discord':11,26,44 'discord.py':15 'featur':27 'fork':13 'irregular':38 'keep':21 'major':40 'modern':5 'new':25 'nextcord':1,2 'python':7,33 'releas':35 'rough':42 'support':32 'updat':41 'v1.7.3':17 'version':29 'wrapper':8 'year':43","created_at":"2026-06-07T12:55:34.521511+00:00","updated_at":"2026-06-07T12:55:34.521511+00:00","problems":[{"fix":"Rename your file (e.g., my_bot.py). Upgrade nextcord: pip install -U nextcord.","cause":"Maybe you have a file named nextcord.py shadowing the module, or installed an old version (pre-1.0).","error":"AttributeError: module 'nextcord' has no attribute 'Intents'"},{"fix":"Use `from nextcord.ext import commands` and instantiate `bot = commands.Bot(command_prefix='!', intents=...)`.","cause":"Using `from nextcord import Client` and trying to use the command decorator. The decorator requires `commands.Bot`.","error":"AttributeError: 'Client' object has no attribute 'command'"},{"fix":"Enable them in the Discord Developer Portal under 'Bot' settings. Then update code: `intents = nextcord.Intents.all()` or explicit intents.","cause":"Your bot uses intents requiring special enablement (members, presences, message content).","error":"discord.errors.PrivilegedIntentsRequired"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/nextcord/nextcord","github":"https://github.com/nextcord/nextcord","docs":null,"changelog":null,"pypi":null,"npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["communication"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-29","install_tag":null}}