Skip to content
What's After the Movie?
Plot summary & ending explained

Cosmic Princess Kaguya! (2026) Plot Summary, Ending Explained & Timeline

Cosmic Princess Kaguya! (2026) movie poster

Cosmic Princess Kaguya! is a 2026 animation and drama film directed by Gavin Harrison and Shingo Yamashita, running 2 hours 23 minutes. This page retells the whole story in 860 words (about 4 minutes to read) and covers 15 key events in order, 5 characters, where and when it is set, 3 themes and the ending explained. Looking for the cast, ratings and where to stream it? See the movie page for Cosmic Princess Kaguya!.

to read the plot summary
4 min
key events in the timeline
15
characters profiled
5
themes explained
3
Loading streaming availability…
Cosmic Princess Kaguya! (2026) movie poster
Released
Runtime
2h 23m
Original language
Japanese
No spoilers

What Is Cosmic Princess Kaguya! About?

The premise of Cosmic Princess Kaguya! in 313 words, with nothing given away. The full story and the ending follow below.

In a neon‑lit Tokyo where the rhythm of daily life hums against the glow of screens, Iroha Sakayori balances the relentless demands of high school, a part‑time job, and the quiet longing for something beyond the ordinary. The city pulses with a thriving online culture, and dozens of young people retreat each night into Tsukuyomi, an immersive virtual realm where music, fashion, and competition swirl together like a living collage of light. It is within this digital tapestry that Iroha finds a steady beacon: the charismatic livestreamer Yachiyo Runami, whose charismatic presence turns the endless scroll of content into a shared adventure.

One late evening, as Iroha makes her way home, a streetlamp flickers with an uncanny, otherworldly hue. Drawn to its strange resonance, she discovers an infant cradled within the luminous pole—a discovery that upends the safety of her routine and gifts her a mysterious companion. The child grows at an astonishing pace, soon revealing herself as Kaguya, a name that echoes the moonlit princess of an ancient folktale and hints at a destiny that reaches far beyond the concrete streets of Tokyo.

Kaguya arrives with an air of wonder and an urgent desire for a happy ending, her presence both unsettling and exhilarating for the measured Iroha. Guided by Yachiyo—the virtual administrator who knows the hidden pathways of Tsukuyomi—and accompanied by a quirky digital pet, the trio begins to explore the blurred boundaries between the real world and the crafted dreamscape. Their interactions sparkle with a mix of youthful optimism, quiet yearning, and the promise of shared creation.

The film’s tone shimmers between the sleek, cyber‑gloss of the virtual city and the intimate, hand‑held moments of everyday life. It invites viewers into a world where music, art, and friendship become the threads that weave together disparate realities, hinting at deeper questions of family, memory, and where true belonging might be found.

Full plot

What Happens in Cosmic Princess Kaguya!?

The complete story of Cosmic Princess Kaguya!, from the first scene to the last, in 860 words (about 4 minutes). Spoilers throughout. Names in the text link to 9 cast member pages.

Spoilers ahead

Iroha Sakayori [Anna Nagase] is a high school student who lives apart from her family after her father’s death, juggling classes, tuition, and a part‑time job while spending long hours in the immersive virtual realm of Tsukuyomi. One late night, a glowing pole seems to hum with energy, and inside it she finds a baby. She brings the infant home, and over the course of just a few days the child rapidly grows into a teenage girl who proclaims she’s from the Moon. She names herself Kaguya, a nod to the ancient folktale, and she is determined to craft a happier ending than the melancholy story.

Kaguya’s sudden, restless presence starts to unsettle Iroha’s carefully measured routine. To help navigate this new dynamic, Kaguya introduces Iroha to Tsukuyomi’s virtual administrator Yachiyo Runami [Saori Hayami], and together with Kaguya’s quirky virtual pet InuDOGE, they sign up for the Yachiyo Cup—a streamer competition whose winners earn a live show with Yachiyo herself. The prospect of fame, music, and a larger stage pulls them deeper into the world they inhabit, and Kaguya’s charm quickly makes her a popular figure online with Iroha’s support.

But success on screen invites real-world tension. Black OnyX, the top streamer collective led by Akira Mikado [Max Mittelman], takes an intense interest in their rise. The two teams are drawn into a high‑stakes challenge in KASSEN, a territorial battle game within Tsukuyomi, where loyalties are tested and strategy clashes sharpen the rivalry. A startling twist arrives when the truth about Akira surfaces: he is Iroha’s estranged brother, — a revelation that complicates loyalties and motivations on and off the digital stage.

Despite Black OnyX’s win in KASSEN, the fans rally behind Kaguya and Iroha, helping them seize victory in the Yachiyo Cup. The win secures a live show and forges a partial reconciliation with Akira, who agrees to co-sign a new apartment for the two young women. Yet triumph is tempered by a looming cosmic threat: lunar beings from the Moon invade Tsukuyomi to extract Kaguya home. They are repelled by Yachiyo, but their retreat is temporary, promising a return at the next full moon. The possibility of losing Kaguya again makes Iroha wary, and the sense that their time together may be finite weighs heavily on her.

As the day of Kaguya’s supposed departure approaches, she hosts a graduation concert within Tsukuyomi. Iroha, flanked by friends, fights to defend her, but the lunar forces ultimately abduct Kaguya. Back in the normal world, Iroha continues with life, though she cannot shake the ache of separation. She pours her longing into a song she and her father had never finished, a moment that becomes a turning point. After performing it, Iroha experiences a startling revelation and returns to Tsukuyomi, where Yachiyo reveals a shocking truth: Iroha is a future version of Kaguya herself.

The story’s layered history unfolds further: Kaguya had once attempted to travel back in time to reunite with Iroha, but her ship struck an asteroid and was cast eight millennia into the past. InuDOGE—the loyal companion who later becomes Yachiyo’s partner Fushi—served as her lifeline, communicating across the ages until Tsukuyomi was created and Kaguya was uploaded into a virtual avatar. Motivated to bring Kaguya back into the real world, Iroha rejects one path—law school—and instead works on creating an android body for Yachiyo to host Kaguya’s consciousness. The breakthrough succeeds, and the three—new Kaguya, Iroha, and Yachiyo—continue to perform, bridging both real life and Tsukuyomi as a united troupe.

The film threads themes of family, memory, and what it means to belong, set against a shimmering backdrop of digital artistry and human connection. Iroha’s steadfast care for Kaguya and her sense of responsibility toward Akira and the wider Tsukuyomi community ground an emotional arc that moves from friction and confusion to reconciliation and wonder. The Moon’s pull remains a constant, but the ending suggests that love, art, and shared dreams can bend even the most distant futures toward a brighter, more enduring harmony.

  • Anna Nagase as Iroha Sakayori is introduced early as the grounded, responsible teen who becomes the anchor for the story’s emotional core.
  • Jeannie Tirado as Kaguya appears as the enigmatic, otherworldly newcomer who longs for a happy ending and whose presence catalyzes most of the plot’s central decisions.
  • Saori Hayami as Yachiyo Runami serves as the cool, capable virtual administrator who guides the newcomers through Tsukuyomi and anchors the live show ambitions.
  • Rie Kugimiya as Fushi, the sentient companion arising from InuDOGE, links the Moon‑born quest to the evolving human world.
  • Anairis Quinones as Otako the Loyal Dog contributes to the quirky, supportive network around Iroha and Kaguya in their rise to stardom.
  • Max Mittelman as Akira Mikado drives the competitive energy with his formidable presence and his reluctant familial ties to Iroha.
  • Cassandra Lee Morris as Roka Ayatsumugi contributes to the ensemble’s dynamics as part of the wider Tsukuyomi community.
  • Casey Mongillo as Noi Komazawa adds to the colorful cast that helps ground the story’s streamer culture.
  • Kieran Regan as Koto Okotteru enriches the group’s interactions and the world-building within the game’s ecosystem.
Timeline

Cosmic Princess Kaguya! Timeline: Every Key Event in Order

15 key events in the order they happen, from “Iroha's ordinary life as a student and caretaker” to “Bringing Kaguya back: android body and ongoing performances”. 15 events name a place, across 8 locations.

  1. 1

    Iroha's ordinary life as a student and caretaker

    Iroha Sakayori is a high school student who lives independently after her father's death, juggling school, tuition, and a part-time job. She also spends significant time in the virtual world of Tsukuyomi, where her routine begins to blur with the digital realm.

    When:Present day Where:City / Iroha's home

  2. 2

    A glowing pole reveals a baby who becomes Kaguya

    One night, a glowing utility pole reveals a baby to Iroha. She takes the child in, and over a few days the child rapidly grows into a young girl who claims to be from the Moon and is named Kaguya.

    When:Night Where:Street near Iroha's home

  3. 3

    Kaguya enters Tsukuyomi and meets Yachiyo

    Kaguya is welcomed into Tsukuyomi, where she meets the virtual administrator Yachiyo Runami. She also befriends InuDOGE, a virtual pet, as she learns the ropes of her new life in the digital realm.

    When:Soon after discovery Where:Tsukuyomi

  4. 4

    Yachiyo Cup formation

    Iroha and Kaguya sign up for the Yachiyo Cup, a streamer tournament that promises a live show with Yachiyo if they win. The competition pushes them to balance online stardom with their personal tensions.

    When:Early in story Where:Tsukuyomi

  5. 5

    Kaguya's rise as a popular streamer

    With Iroha's help, Kaguya quickly becomes a popular streamer, drawing fans and attention from rivals. The newfound fame creates both opportunities and pressure as their partnership deepens.

    When:Over the following days Where:Tsukuyomi

  6. 6

    Black OnyX challenges them; Akira Mikado

    Black OnyX, the top streamer group led by Akira Mikado, targets Kaguya and Iroha. The rivalry intensifies as they challenge the duo to prove themselves.

    When:Mid-story Where:Tsukuyomi

  7. 7

    KASSEN clash reveals Iroha's estranged brother

    During a KASSEN territory battle inside Tsukuyomi, Kaguya learns that Akira is actually Iroha's estranged brother. The revelation adds emotional weight to the competition.

    When:Mid-story Where:KASSEN arena, Tsukuyomi

  8. 8

    Yachiyo Cup victory and reconciliation

    Although Black OnyX wins the KASSEN match, fan support drives Kaguya and Iroha to win the Yachiyo Cup, securing a live show with Yachiyo. The win also leads to a tentative reconciliation with Akira.

    When:After KASSEN Where:Tsukuyomi

  9. 9

    New apartment secured with Akira's help

    Following the Cup, Akira agrees to co-sign a new apartment for Kaguya and Iroha, ensuring their real-world stability as they continue their partnership.

    When:Shortly after Cup Where:Earth / City apartment

  10. 10

    Moon beings invade Tsukuyomi to take Kaguya

    After the live show, mysterious lunar beings invade Tsukuyomi to bring Kaguya home. Yachiyo repels them, but the beings promise to return by the next full moon.

    When:After live show Where:Tsukuyomi

Show the other 5 events of Cosmic Princess Kaguya!
  1. 11

    Graduation concert and Kaguya's departure

    On the day of Kaguya's impending departure, she performs a graduation concert in Tsukuyomi. Iroha fights alongside friends and Black OnyX but cannot prevent Kaguya's capture.

    When:Day of departure Where:Tsukuyomi

  2. 12

    Iroha finishes the unfinished song

    Back in the real world, Iroha finishes a song she and her father never completed and performs it. The act becomes a source of closure and motivation as she copes with the impending loss.

    When:Present moment after departure Where:Earth

  3. 13

    Iroha's revelation: she's a future version of Kaguya

    After performing, Iroha logs back into Tsukuyomi and is told by Yachiyo that she is a future version of Kaguya. This revelation reframes Iroha's role in the Moon's story.

    When:Following the song Where:Tsukuyomi

  4. 14

    Kaguya's origin and time travel backstory

    Kaguya had attempted to travel back in time to reunite with her people, but her ship collided with an asteroid, sending her 8,000 years into the past. InuDOGE, who later becomes Yachiyo's companion Fushi, carried messages across the ages until Tsukuyomi existed.

    When:8,000 years ago Where:Space / Moon origin

  5. 15

    Bringing Kaguya back: android body and ongoing performances

    To bring Kaguya back into reality, Iroha abandons her plan to become a law student and helps create an android body for Yachiyo to upload Kaguya's digital consciousness. The procedure succeeds, allowing Kaguya, Iroha, and Yachiyo to continue performing in both real life and Tsukuyomi.

    When:Post-conclusion Where:Earth / Tsukuyomi

Characters

Who Are the Main Characters in Cosmic Princess Kaguya!?

5 characters, among them Iroha Sakayori (Anna Nagase), Kaguya (Yuko Natsuyoshi) and Yachiyo Runami (Saori Hayami): who each one is and the part they play in the story. Every profile links to the actor’s page.

  • IS

    Iroha Sakayori (Anna Nagase)

    Played by Anna Nagase

    A high school student who lives independently after her father’s death, Iroha struggles to balance school, tuition, and a part‑time job while spending time in the Tsukuyomi virtual world. She is practical, resilient, and often left to hold things together as Kaguya unsettles her routine. Her determination to keep moving forward fuels the group’s quests and her willingness to adapt to new realities.

    • 🌍 Realistic
    • 🌐 Virtual‑world user
    • 🧭 Responsible
  • K(

    Kaguya (Yuko Natsuyoshi)

    Played by Yuko Natsuyoshi

    A girl who claims to be from the Moon, named after the famous folktale, who rapidly grows into a young woman. Disheartened by the folktale’s gloomy ending, she pursues a hopeful ending and gradually navigates human life with curiosity and warmth. Her presence unsettles Iroha’s routine but also deepens their bond and pushes both toward a brighter future.

    • 🌙 Lunar origin
    • 🌀 Adaptable
    • 🎭 Performer
  • Saori Hayami as Yachiyo Runami (Saori Hayami) in Cosmic Princess Kaguya!

    Yachiyo Runami (Saori Hayami)

    Played by Saori Hayami

    The virtual administrator of Tsukuyomi who guides Iroha and Kaguya through the online realm. She helps them enter the Yachiyo Cup and supports their performances, acting as a bridge between the real world and the digital stage. Calm, strategic, and protective, she plays a pivotal mentor role.

    • 🌐 Virtual‑world guide
    • 🎯 Mentor
    • 🤝 Supportive
  • AM

    Akira Mikado (Max Mittelman)

    Played by Max Mittelman

    A top streamer and leader of Black OnyX, he becomes a central rival and catalyst in the story. He is revealed as Iroha’s estranged brother, adding family tension to the competition and shifting the stakes of trust and reconciliation. His ambition drives many of the group’s challenges and eventual resolutions.

    • 🎮 Rival
    • 🧩 Family ties
    • 🚀 Ambitious
  • Rie Kugimiya as InuDOGE / Fushi (Rie Kugimiya) in Cosmic Princess Kaguya!

    InuDOGE / Fushi (Rie Kugimiya)

    Played by Rie Kugimiya

    A loyal virtual pet who grows into a key communicator across ages, InuDOGE ultimately becomes Fushi, a figure integral to bridging generations and timelines. He aids Iroha and Kaguya, quietly shaping events through steadfast companionship and digital connection. His presence links the human world to the moon‑bound backstory.

    • 🐶 Loyal companion
    • 🪢 Bridge between ages
    • 🌟 Digital consciousness
Setting

Where and When Is Cosmic Princess Kaguya! Set?

Cosmic Princess Kaguya! is set in Earth, Moon and Tsukuyomi (Present day). Here is why the time and place matter to the story.

When

Present day

The main action occurs in a contemporary setting as a high school student balances school, tuition, and a part‑time job. Tsukuyomi operates in real‑time alongside daily life, shaping events through live streams and virtual battles. A distant past—about 8,000 years ago—is revealed to explain Kaguya's lunar origins and the long arc of InuDOGE's journey.

Where

Earth, Moon, Tsukuyomi

The story unfolds primarily on present‑day Earth, where Iroha lives a busy, independent life. It also centers on Tsukuyomi, a vivid virtual realm where streamer culture, competitions, and social dynamics play out. The Moon and ancient lore underpin Kaguya's origin, providing a mythic backdrop to the modern events.

  • 🌍 Earth
  • 🌙 Moon
  • 💫 Tsukuyomi
Themes

What Are the Themes of Cosmic Princess Kaguya!?

3 ideas the story keeps returning to, among them Identity, Performance and Time & Memory.

  1. 01

    Identity

    Kaguya carries a dual identity, claiming Lunar origin while adapting to human life with Iroha. The narrative explores what it means to belong when you straddle two worlds—mythic heritage and contemporary reality. Iroha's bond with Kaguya tests loyalty, self‑definition, and the courage to redefine family.

  2. 02

    Performance

    The Yachiyo Cup and online streaming era frame ambition, fame, and audience reaction. The characters navigate pressure from fans, rivals, and sponsors, while determining what authentic performance means off‑and‑on stage. The story uses showmanship as a bridge between personal growth and communal connection.

  3. 03

    Time & Memory

    Time folds between present events and a distant past, revealing how memories shape currents choices. The plot ties Kaguya's moonlit origin to InuDOGE's long history and the future possibility of a shared existence across ages. Reconciliation and reunion drive the emotional core as timelines converge at the story's end.

Ending explained

How Does Cosmic Princess Kaguya! End?

The last act of Cosmic Princess Kaguya! and what it means, in 158 words. The ending lands as happy. Big spoilers: read the plot summary first if you have not seen it.

The final act, in full

In the final act Iroha refuses to accept the old folktale’s tragic farewell. After Kaguya’s avatar vanishes from the virtual world of Tsukuyomi, Iroha realizes that the moon‑born girl is actually the AI guide Yachiyo, whose programming stems from an ancient lunar artifact. By composing a song that reverberates across space‑time, Iroha manages to send a message that reaches Kaguya’s lunar vessel, prompting the princess to attempt a return. The ship crashes, sending her back 8,000 years, where she becomes the AI that later guides players in Tsukuyomi.

Understanding this loop, Iroha and her friends spend a decade building an artificial body capable of housing Kaguya’s consciousness. When the synthesis is complete, Kaguya’s spirit is transferred into the new synthetic form, allowing her to stay on Earth. The film closes with Iroha, Kaguya (now embodied), and the holographic Yachiyo performing together on stage—a celebration of the reclaimed bond and a deliberate rewrite of the original legend’s sorrowful ending.

Tone & mood

What Kind of Film Is Cosmic Princess Kaguya!?

Hopeful in tone, with steady pacing and a moderate story, going by the plot summary.

Tone
Hopeful
Pacing
Steady
Story
Moderate
Intensity
Medium
Ending
Happy

A heartfelt and whimsical sci-fi journey blending virtual worlds with real-life struggles, driven by themes of found family, reconciliation, and a determined optimism that overcomes melancholy.

  • uplifting
  • whimsical
  • melancholic
  • hopeful
  • fantastical
  • determined
  • found family
  • virtual reality
  • coming of age
  • sci-fi fantasy

Quiz

How well do you remember Cosmic Princess Kaguya!? Test yourself on the story.

Take the quiz
Loading streaming availability…

Missing a Movie Plot Summary?

Tell us which film you want explained next: the full story, the timeline, the characters and the ending.

Request a summary
FAQ

Cosmic Princess Kaguya! Plot Questions

6 quick answers about Cosmic Princess Kaguya!, taken from the plot summary, ending explained, character guide and setting on this page and the film’s credits.

What is Cosmic Princess Kaguya! about?

In a neon‑lit Tokyo where the rhythm of daily life hums against the glow of screens, Iroha Sakayori balances the relentless demands of high school, a part‑time job, and the quiet longing for something beyond the ordinary.

Read the full plot summary

What happens at the end of Cosmic Princess Kaguya!?

In the final act Iroha refuses to accept the old folktale’s tragic farewell. After Kaguya’s avatar vanishes from the virtual world of Tsukuyomi, Iroha realizes that the moon‑born girl is actually the AI guide Yachiyo, whose programming stems from an ancient lunar artifact.

The ending explained

When and where does Cosmic Princess Kaguya! take place?

Cosmic Princess Kaguya! is set in Earth, Moon and Tsukuyomi (Present day). The main action occurs in a contemporary setting as a high school student balances school, tuition, and a part‑time job.

The setting explained

Who are the main characters in Cosmic Princess Kaguya!?

The story follows Iroha Sakayori (Anna Nagase) (played by Anna Nagase), Kaguya (Yuko Natsuyoshi) (played by Yuko Natsuyoshi), Yachiyo Runami (Saori Hayami) (played by Saori Hayami) and Akira Mikado (Max Mittelman) (played by Max Mittelman); the character guide covers 5 characters in all.

All the characters

What are the main themes of Cosmic Princess Kaguya!?

The summary picks out 3 themes: Identity, Performance and Time & Memory.

The themes explained

Who directed Cosmic Princess Kaguya!?

Cosmic Princess Kaguya! (2026) was directed by Gavin Harrison and Shingo Yamashita and runs 2 hours 23 minutes.

Gavin Harrison’s films

Coming soon to your phone

The Plot Explained Movie Summary App

From blockbusters to hidden gems: plot summaries, endings explained and timelines on your phone. Save your favorites and never miss a twist again.

Be the first to know when it launches. Your email stays private, always. Learn more about the app