graphene-file-upload
Lib for adding file upload functionality to GraphQL mutations in Graphene Django and Flask-Graphql
Decision gist · record as of 2026-08-14
No—not for new projects. The package is abandoned (last release 2021-02-20) and will not receive security updates or compatibility fixes for modern Django/Flask versions. If you have a legacy codebase already using it and locked to compatible dependency versions, it may work, but for new development, consider maintaining file upload logic directly in your view layer or using an actively maintained alternative.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Graphene and either Django or Flask-Graphql to be installed separately; Flask-Graphql version 2.0+ is required for Flask integration.
- Low install friction with a single runtime dependency (six).
- However, the package is abandoned—last release was 2021-02-20, with no recent maintenance or security updates.
License · maintenance · safety
permissive license (permissive) — MIT license (permissive); you can use, modify, and distribute this package freely in both open-source and commercial projects with minimal restrictions.
last release 2021-02-20 (2001 days) · last repo commit 2022-12-15 · 287 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 334,378 downloads/mo, #7,490 on PyPI
Alternatives
Verify before relying
pip install graphene-file-upload
from graphene_file_upload.scalars import Upload
import graphene
class UploadMutation(graphene.Mutation):
class Arguments:
file = Upload(required=True)
success = graphene.Boolean()
def mutate(self, info, file, **kwargs):
return UploadMutation(success=True)- Whether this package works with current versions of Django and Flask-Graphql given its abandonment since 2021-02-20.
- Whether six dependency is still necessary or if it can be removed for modern Python 3 only codebases.
- Security implications of using an unmaintained package in production GraphQL APIs.
What it is and what it does
graphene-file-upload is a drop-in replacement for the default GraphQL view in Graphene for Django and Flask-Graphql that adds support for multipart file uploads. It provides an Upload scalar type you can use in your GraphQL mutations to accept file arguments, and it handles the multipart request protocol that GraphQL clients use to send files alongside GraphQL queries.
The package integrates at the view layer—you swap out the standard GraphQL view for FileUploadGraphQLView in your URL configuration, then use the Upload scalar in your mutation arguments. It includes testing helpers for both Django and Flask to make it easier to write tests for file-upload mutations. However, the package has not been maintained since 2021-02-20 and may not be compatible with recent versions of its dependencies.
Use it for
- Accept file uploads in GraphQL mutations for Django or Flask-based GraphQL APIs without writing custom multipart handling.
- Test file-upload mutations in Django or Flask using the provided file_graphql_query helper and test case classes.
- Integrate GraphQL clients that send files via the standard multipart request spec with Graphene backends.
- Add avatar or document upload endpoints to a Graphene GraphQL API with minimal boilerplate.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
No—not for new projects.
The package is abandoned (last release 2021-02-20) and will not receive security updates or compatibility fixes for modern Django/Flask versions. If you have a legacy codebase already using it and locked to compatible dependency versions, it may work, but for new development, consider maintaining file upload logic directly in your view layer or using an actively maintained alternative.
Install
graphene-file-upload on PyPI
Before you install
Low install friction with a single runtime dependency (six). However, the package is abandoned—last release was 2021-02-20, with no recent maintenance or security updates.
Requires Graphene and either Django or Flask-Graphql to be installed separately; Flask-Graphql version 2.0+ is required for Flask integration.
License in practice
MIT license (permissive); you can use, modify, and distribute this package freely in both open-source and commercial projects with minimal restrictions.
Quickstart
pip install graphene-file-upload
from graphene_file_upload.scalars import Upload
import graphene
class UploadMutation(graphene.Mutation):
class Arguments:
file = Upload(required=True)
success = graphene.Boolean()
def mutate(self, info, file, **kwargs):
return UploadMutation(success=True)Verify before relying
- Whether this package works with current versions of Django and Flask-Graphql given its abandonment since 2021-02-20.
- Whether six dependency is still necessary or if it can be removed for modern Python 3 only codebases.
- Security implications of using an unmaintained package in production GraphQL APIs.
Package facts
| License | permissive license permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagesix |
| Maintenance | Abandoned 2,001 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 334,378 / month, #7,490 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableFramework :: Django :: 1.11Framework :: Django :: 2.0Framework :: Django :: 2.1Framework :: Django :: 2.2Framework :: Django :: 3.0Framework :: Django :: 3.1Framework :: FlaskIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseNatural Language :: EnglishOperating System :: OS IndependentProgramming Language :: Python :: 2.7Programming Language :: Python :: 3.4Programming Language :: Python :: 3.5Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPyTopic :: Internet :: WWW/HTTP |
Evidence: graphene_file_upload-1.3.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “graphql file upload”
- graphene-file-uploadAdds file upload support to GraphQL mutations in Graphene-based…
- starlette-graphene3Mounts a GraphQL API built with Graphene v3 onto a Starlette or…
- crowdin-api-clientA lightweight Python client library for the Crowdin API that enables…
Give your agent the search over MCP, or paste the wish link into any chat.
More WWW/HTTP packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
HTTPX is a fully featured HTTP client library for Python that provides both sync and async APIs, with support for HTTP/1.1 and HTTP/2, plus an integrated command-line client.
Install it if you are building new projects or modernizing existing ones that rely on HTTP.
A minimal low-level HTTP client library that sends HTTP requests with thread-safe and task-safe connection pooling, supporting HTTP/1.1, HTTP/2, proxies, and both sync and async interfaces.
aiohttp is an async HTTP client and server framework built on asyncio, supporting both WebSockets and middleware-based routing for building concurrent web applications.
Install it if you need async HTTP client or server capabilities in asyncio-based applications.
See also Flask-GraphQL · graphene-django · starlette-graphene3 · graphene · graphene-federation · django-graphql-jwt · graphene-sqlalchemy · graphene-django-optimizer · pydgraph · cosmic-ray